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

Vytváření úloh live ‘DataForSEO Search Volume’

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

Vytváření úloh live ‘DataForSEO Search Volume’

​

Hledanost odvozená z panelů clickstream, nikoli z reklamních platforem, pro seznam keywords. use_clickstream přepíná mísení. Vrací location_code, language_code, use_clickstream, items_count a items. 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. Hledanost z clickstreamu se často rozchází s post_dataforseo_keywords_gads_search_volume_live, a o to jde: jedno měří, co se ukazuje inzerentům, druhé, co lidé udělali.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.09.
  • Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na 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)[]
    • keywords
      Typ: array string[]

      cílová klíčová slova
      povinné pole
      kódování UTF-8
      maximální počet klíčových slov, která můžete v tomto poli zadat: 1000
      klíčová slova se převedou na malá písmena

      Poznámka: některé symboly a znaky (např. symboly UTF, emoji) nejsou povoleny
      informace o tom, které symboly a znaky lze použít, najdete v tomto článku

      další informace o pravidlech a omezeních polí keyword a keywords v rozhraních DataForSEO najdete v tomto článku nápovědy

    • language_code
      Typ: string

      kód jazyka vyhledávače
      povinné pole, pokud nezadáte language_name
      seznam dostupných jazyků s jejich language_code získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      příklad:
      en

    • language_name
      Typ: string

      úplný název jazyka vyhledávače
      povinné pole, pokud nezadáte language_code
      seznam dostupných jazyků s jejich language_name získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      příklad:
      English

    • location_code
      Typ: integer

      kód lokality vyhledávače
      povinné pole, pokud nezadáte location_name
      pokud toto pole použijete, seznam dostupných lokalit s location_code získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      příklad:
      2826

    • location_name
      Typ: string

      úplný název lokality vyhledávače
      povinné pole, pokud nezadáte location_code
      seznam dostupných lokalit s location_name získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      příklad:
      United Kingdom

    • 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

    • use_clickstream
      Typ: boolean | null

      použít data clickstream k poskytování výsledků
      volitelné pole
      pokud je nastaveno na true, získáte hodnoty objemu vyhledávání DataForSEO založené na datech clickstream;
      pokud je nastaveno na false, k výpočtu objemu vyhledávání DataForSEO se použijí data objemu vyhledávání Bing;
      výchozí hodnota: true;
      Poznámka: objem vyhledávání Bing je k dispozici pro lokality uvedené v koncových bodech Bing Search Volume History Locations a Bing Ads Locations; hodnoty objemu vyhledávání pro jakoukoli jinou lokalitu se vypočítají na základě dat clickstream, i když tento parametr nastavíte na false

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveResponseInfo
    • 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_KeywordsDataClickstreamDataDataforseoSearchVolumeLiveTaskInfo
        • 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ů

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

            pole klíčových slov
            obsahuje klíčová slova a jejich objemy vyhledávání

            • keyword
              Typ: string | null

              klíčové slovo zadané v poli POST

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

              míry měsíční hledanosti
              pole objektů s mírami hledanosti v určitém měsíci roku

              • month
                Typ: integer | null

                Měsíc.

              • search_volume
                Typ: integer | null

                průměrná měsíční hledanost

              • year
                Typ: integer | null

                Rok.

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

              aktuální hledanost klíčového slova

          • items_count
            Typ: integer | null

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

          • language_code
            Typ: string | null

            kód jazyka v poli POST

            Poznámka: pokud je klíčové slovo v poli POST napsáno chybně, data budou vrácena pro správně napsané klíčové slovo;
            kontrolu a ověření pravopisu klíčových slov provádíme pomocí funkce Google Ads API, více se dozvíte na tomto odkazu

          • location_code
            Typ: integer | null

            kód lokality v poli POST
            pokud nejsou k dispozici žádná data, hodnota je null

          • use_clickstream
            Typ: boolean | null

            udává, zda je parametr use_clickstream aktivní
            možné hodnoty: true, false

        • 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/keywords_data/clickstream_data/dataforseo_search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

{
  "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": [
        {
          "location_code": null,
          "language_code": null,
          "use_clickstream": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Setting Live ‘DataForSEO Search Volume’ Tasks