Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Živý YouTube Organic Advanced

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operace

Živý YouTube Organic Advanced

​

Synchronně vrací výsledky v pořadí pro klíčové slovo v YouTube. Vrací keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count a items. advanced je výchozí volba; vezměte regular, když záleží jen na seznamu pořadí, a html jen pro kontrolu, co parser zahodil. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.002.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
application/json
  • Typ: array (object | null)[]
    • block_depth
      Typ: integer | null

      hloubka analýzy volitelné pole počet bloků výsledků v SERP výchozí hodnota: 20 maximální hodnota: 200 Poznámka: váš účet bude účtován za každý SERP obsahující až 20 výsledků; proto nastavení hloubky bloků nad 20 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 20 výsledků; pokud je zadaná hloubka bloků vyšší než počet výsledků v odpovědi, rozdíl bude automaticky vrácen na zůstatek vašeho účtu

    • device
      Typ: string | null

      typ zařízení volitelné pole vracet výsledky pro určitý typ zařízení dostupné hodnoty: desktop, mobile

    • keyword
      Typ: string

      keyword povinné pole v poli keyword můžete zadat až 700 znaků všechny %## budou dekódovány (znak „+“ bude dekódován jako mezera) pokud potřebujete v poli keyword použít znak „%“, zadejte jej jako „%25“; pokud potřebujete v poli keyword použít znak „+“, zadejte jej jako „%2B“; další informace o pravidlech a omezeních polí keyword a keywords v rozhraních API DataForSEO najdete v tomto článku Centra nápovědy

    • language_code
      Typ: string | null

      kód jazyka vyhledávače povinné pole, pokud nezadáte language_name pokud toto pole použijete, nemusíte zadávat language_name seznam dostupných jazyků vyhledávače s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/languages příklad: en

    • language_name
      Typ: string | null

      úplný název jazyka vyhledávače povinné pole, pokud nezadáte language_code pokud toto pole použijete, nemusíte zadávat language_code seznam dostupných jazyků vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/languages příklad: English

    • location_code
      Typ: integer | null

      kód lokality vyhledávače povinné pole, pokud nezadáte location_name pokud toto pole použijete, nemusíte zadávat location_name seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/locations příklad: 2840

    • location_name
      Typ: string | null

      úplný název lokality vyhledávače povinné pole, pokud nezadáte location_code pokud toto pole použijete, nemusíte zadávat location_code seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/locations příklad: United States

    • os
      Typ: string | null

      operační systém zařízení volitelné pole pokud v poli device zadáte desktop, vyberte z následujících hodnot: windows, macos výchozí hodnota: windows pokud v poli device zadáte mobile, vyberte z následujících hodnot: android, ios výchozí hodnota: android

    • search_param
      Typ: string | null

      další parametry vyhledávacího dotazu volitelné pole příklad: sp=EgIQAg%253D%253D

    • tag
      Typ: string | null

      uživatelem definovaný identifikátor úlohy volitelné pole limit znaků je 255 tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem zadanou hodnotu tag najdete v objektu data odpovědi

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedResponseInfo
    • cost
      Typ: number | null Formát: double

      celkové náklady na úlohy, USD

    • status_code
      Typ: integer | null

      obecný kód stavu úplný seznam kódů odpovědí najdete zde

    • status_message
      Typ: string | null

      obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

    • tasks
      Typ: array (object | null)[] | null

      pole úloh

      • Typ: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedTaskInfo
        • cost
          Typ: number | null Formát: double

          celkové náklady na úlohy, USD

        • data
          Typ: object | null

          obsahuje stejné parametry, které jste zadali v požadavku POST

          • propertyName
            Typ: object | null
        • id
          Typ: string | null

          identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

        • path
          Typ: array (string | null)[] | null

          cesta URL

        • result
          Typ: array (object | null)[] | null

          pole výsledků

          • check_url
            Typ: string | null

            přímá adresa URL na výsledky vyhledávání můžete ji použít k ověření, že jsme poskytli přesné výsledky

          • datetime
            Typ: string | null

            datum a čas přijetí výsledku ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00” příklad: 2019-11-15 12:57:46 +00:00

          • item_types
            Typ: array (string | null)[] | null

            typy výsledků vyhledávání v SERP obsahuje typy výsledků vyhledávání (items) nalezených v SERP. možné typy položek: youtube_channel, youtube_video, youtube_video_paid, youtube_playlist

          • items
            Typ: array (object | null)[] | null

            položky výsledků vyhledávání nalezené v SERP

            • block_name
              Typ: string | null

              název bloku v SERP
              příklad:
              "People also watched"

            • block_rank
              Typ: integer | null

              pořadí bloku v SERP
              pozice mezi všemi bloky v SERP

            • channel_id
              Typ: string | null

              ID kanálu

            • rank_absolute
              Typ: integer | null

              absolutní pořadí v SERP pro cílovou doménu
              absolutní pozice mezi všemi prvky v SERP

            • rank_group
              Typ: integer | null

              pořadí skupiny v SERP
              pozice ve skupině prvků se shodnými hodnotami type
              pozice prvků s jinými hodnotami type se v rank_group vynechávají

            • type
              Typ: string | null

              typ prvku

            • url
              Typ: string | null

              URL kanálu

          • items_count
            Typ: integer | null Formát: int64

            Počet výsledků vrácených v poli items.

          • keyword
            Typ: string | null

            klíčové slovo přijaté v poli POST klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera)

          • language_code
            Typ: string | null

            Kód jazyka v poli POST.

          • location_code
            Typ: integer | null

            Kód lokality v poli POST.

          • se_domain
            Typ: string | null

            doména vyhledávače v poli POST

          • se_results_count
            Typ: integer | null Formát: int64

            celkový počet výsledků v SERP

          • spell
            Typ: object | null · Response36Afe1097B20_SpellInfo

            automatická oprava vyhledávače pokud vyhledávač poskytl výsledky pro opravené klíčové slovo, uvedeme klíčové slovo opravené vyhledávačem a typ automatické opravy

            • keyword
              Typ: string | null

              klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo

            • type
              Typ: string | null

              typ automatické opravy možné hodnoty: did_you_mean, showing_results_for, no_results_found_for, including_results_for poznámka: Yahoo a Yandex podporují pouze následující typ automatické opravy: including_results_for

        • result_count
          Typ: integer | null Formát: int64

          počet prvků v poli result

        • status_code
          Typ: integer | null

          stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

        • status_message
          Typ: string | null

          informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

        • time
          Typ: string | null

          doba provedení, sekundy

    • tasks_count
      Typ: integer | null Formát: int64

      počet úloh v poli tasks

    • tasks_error
      Typ: integer | null Formát: int64

      počet úloh v poli tasks vrácených s chybou

    • time
      Typ: string | null

      celková doba provádění, sekundy

    • version
      Typ: string | null

      aktuální verze API

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    application/json
Request Example for post/v1/beta/dataforseo/serp/youtube/organic/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/organic/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "audi"
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "block_rank": null,
              "block_name": null,
              "channel_id": null,
              "url": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Live YouTube Organic Advanced