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

Vytváření úloh live ‘Google Ads 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 ‘Google Ads Search Volume’

​

Hledanost Google Ads pro seznam keywords. Vrací keyword, location_code, language_code, search_partners, competition, competition_index, search_volume, low_top_of_page_bid, high_top_of_page_bid, cpc a monthly_searches, a také spell, když Google termín opravil. 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. Toto je klasický údaj o hledanosti; chcete-li vědět, jak často se lidé ptají asistenta, použijte post_dataforseo_ai_keyword_volume_live. Protějšky pro odeslání a načtení tohoto endpointu dělají stejnou práci asynchronně, za stejnou cenu, pro dávky příliš velké na čekání.

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)[]
    • date_from
      Typ: string | null

      počáteční datum časového rozsahu
      volitelné pole
      formát data: "yyyy-mm-dd"
      minimální hodnota: 4 roky od aktuálního data
      ve výchozím nastavení se data vracejí za posledních 12 měsíců;
      Poznámka: uvedené datum nesmí být větší než datum zadané v date_to a/nebo včerejší datum;pokud koncový bod Status vrátí false v poli actual_data, lze date_from nastavit na předminulý měsíc a dřívější;
      pokud koncový bod Status vrátí true v poli actual_data, lze date_from nastavit na poslední měsíc a dřívější

    • date_to
      Typ: string | null

      koncové datum časového rozsahu
      volitelné pole
      Poznámka: uvedené datum nesmí být pozdější než minulý měsíc; Google Ads nevrací data za aktuální měsíc;
      pokud toto pole nezadáte, použije se ve výchozím nastavení včerejší datum
      formát data: "yyyy-mm-dd"
      příklad:
      "2022-11-30"

    • include_adult_keywords
      Typ: boolean | null

      zahrnout klíčová slova spojená s obsahem pro dospělé
      volitelné pole
      pokud nastavíte true, budou do odpovědi zahrnuta klíčová slova pro dospělé
      výchozí hodnota: false
      mějte na paměti, že rozhraní API nemusí pro taková klíčová slova vracet žádná data kvůli omezením Google Ads

    • keywords
      Typ: array string[]

      keywords
      povinné pole
      maximální počet klíčových slov, která můžete zadat: 1000
      maximální počet znaků pro každé klíčové slovo: 80
      maximální počet slov pro každou klíčovou frázi: 10
      zadaná klíčová slova budou převedena na malá písmena
      Poznámka č. 1: Google Ads nemusí pro určité skupiny klíčových slov vracet žádná data;
      Poznámka č. 2: Google Ads poskytuje kombinované hodnoty objemu vyhledávání pro skupiny podobných klíčových slov
      pro získání objemu vyhledávání podobných klíčových slov doporučujeme odesílat tato klíčová slova v samostatných požadavcích;
      Poznámka č. 3: Google Ads neumožňuje používat určité symboly a znaky (např. symboly UTF, emoji), takže je nelze použít při nastavování úlohy;
      další 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 API DataForSEO najdete v tomto článku Centra nápovědy

    • language_code
      Typ: string | null

      kód jazyka vyhledávače
      volitelné pole
      seznam dostupných jazyků vyhledávače s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      příklad:
      en

    • language_name
      Typ: string | null

      úplný název jazyka vyhledávače
      volitelné pole
      seznam dostupných jazyků vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/google_ads/languages
      příklad:
      English

    • location_code
      Typ: integer | null

      kód lokality vyhledávače
      volitelné pole
      pokud lokalitu nezadáte, obdržíte celosvětové výsledky, tj. pro všechny dostupné lokality;
      pokud toto pole použijete, nemusíte zadávat location_name ani location_coordinate;
      seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      příklad:
      2840

    • location_coordinate
      Typ: string | null

      GPS souřadnice lokality
      volitelné pole
      pokud lokalitu nezadáte, obdržíte celosvětové výsledky, tj. pro všechny dostupné lokality;
      pokud toto pole použijete, nemusíte zadávat location_name ani location_code;
      parametr location_coordinate je nutné zadat ve formátu "latitude,longitude";
      data budou poskytnuta pro zemi, do které zadané souřadnice patří;
      příklad:
      52.6178549,-155.352142

    • location_name
      Typ: string | null

      úplný název lokality vyhledávače
      volitelné pole
      pokud lokalitu nezadáte, obdržíte celosvětové výsledky, tj. pro všechny dostupné lokality;
      pokud toto pole použijete, nemusíte zadávat location_code ani location_coordinate
      seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/google_ads/locations
      příklad:
      London,England,United Kingdom

    • search_partners
      Typ: boolean | null

      zahrnout partnery vyhledávání Google
      volitelné pole
      pokud zadáte true, budou výsledky doručeny pro vlastní, provozované a syndikované sítě v rámci webů Google a partnerských webů, které hostují vyhledávání Google;
      výchozí hodnota: false – výsledky se vracejí pro weby vyhledávání Google

    • sort_by
      Typ: string | null

      parametry řazení výsledků
      volitelné pole
      pomocí těchto parametrů seřaďte výsledky podle relevance, search_volume, competition_index, low_top_of_page_bid nebo high_top_of_page_bid sestupně
      výchozí hodnota: relevance

    • 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 poli data odpovědi

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

          • competition
            Typ: string | null

            konkurence
            představuje relativní míru konkurence spojené s daným klíčovým slovem pouze v placeném SERP;
            hodnota vychází z dat Google Ads a může nabývat následujících hodnot: HIGH, MEDIUM, LOW;
            pokud nejsou k dispozici žádná data, hodnota je null;
            více o této metrice v tomto článku centra nápovědy

          • competition_index
            Typ: integer | null

            konkurence
            představuje relativní míru konkurence spojené s daným klíčovým slovem pouze v placeném SERP;
            hodnota vychází z dat Google Ads a může být v rozmezí od 0 do 100 (včetně);
            pokud nejsou k dispozici žádná data, hodnota je null;
            více o této metrice v tomto článku centra nápovědy

          • cpc
            Typ: number | null

            cena za kliknutí
            udává částku zaplacenou (USD) za každé kliknutí na reklamu zobrazenou pro dané klíčové slovo

          • high_top_of_page_bid
            Typ: number | null

            maximální nabídka, aby se reklama zobrazovala v horní části první stránky
            udává hodnotu vyšší než přibližně 80 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty);
            hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST

          • keyword
            Typ: string | null

            klíčové slovo
            klíčové slovo se vrací s dekódovaným %## (znak '+' bude dekódován jako mezera)

          • language_code
            Typ: string | null

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

          • location_code
            Typ: integer | null

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

          • low_top_of_page_bid
            Typ: number | null

            minimální nabídka, aby se reklama zobrazovala v horní části první stránky
            udává hodnotu vyšší než přibližně 20 % nejnižších nabídek, při kterých se reklamy zobrazovaly (na základě statistik Google Ads pro inzerenty);
            hodnota se může lišit v závislosti na lokalitě uvedené v požadavku POST

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

            měsíční vyhledávání
            představuje (přibližný) počet vyhledávání daného námětu klíčového slova (ve výchozím nastavení dostupný za posledních dvanáct měsíců) v zadaných zeměpisných lokalitách;
            pokud nejsou k dispozici žádná data, hodnota je null

            • 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_partners
            Typ: boolean | null

            udává, zda jsou v odpovědi zahrnuta data z partnerských sítí

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

            průměrná měsíční hledanost;
            představuje (přibližný) počet vyhledávání daného námětu klíčového slova na google.com nebo google.com a partnerech v závislosti na cílení uživatele;
            pokud nejsou k dispozici žádná data, hodnota je null

          • spell
            Typ: string | null

            správný pravopis klíčového slova
            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

        • 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/google_ads/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "buy laptop",
      "cheap laptops for sale",
      "purchase laptop"
    ],
    "date_from": "2021-08-01",
    "search_partners": true
  }
]'

{
  "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,
          "spell": null,
          "location_code": null,
          "language_code": null,
          "search_partners": null,
          "competition": null,
          "competition_index": null,
          "search_volume": null,
          "low_top_of_page_bid": null,
          "high_top_of_page_bid": null,
          "cpc": null,
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Setting Live ‘Google Ads Search Volume’ Tasks