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

Načtení výsledků ‘Ads Traffic By Keywords’ podle id

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

Načtení výsledků ‘Ads Traffic By Keywords’ podle id

​

Načte zařazenou prognózu provozu Google Ads podle id: předpokládaná zobrazení, kliknutí, náklady a průměrnou pozici pro zadanou nabídku. 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. Na rozdíl od objemových endpointů jde o projekci, nikoli měření — čísla se hýbou s bid a match.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.012.
  • 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.

Parametry cesty
  • id
    Typ: string
    povinné

    identifikátor úlohy
    jedinečný identifikátor úlohy v našem systému ve formátu UUID
    můžete jej po dobu 30 dní kdykoli použít k vyžádání výsledků úlohy

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

          • average_cpc
            Typ: number | null Formát: double

            průměrná hodnota ceny za kliknutí
            představuje cenu za kliknutí (USD) odhadnutou pro klíčové slovo na základě zadaného období a historických dat;
            pokud nejsou k dispozici žádná data, hodnota je null

          • bid
            Typ: number | null

            maximální vlastní nabídka
            nabídka, kterou jste zadali při nastavení úlohy
            představuje cenu, kterou jste ochotni za reklamu zaplatit
            čím vyšší hodnotu zadáte, tím vyšší metriky a náklady v odpovědi obdržíte
            více se dozvíte v tomto článku centra nápovědy

          • clicks
            Typ: number | null

            počet kliknutí na reklamu
            počet kliknutí, která má reklama získat v zadaném období
            pokud nejsou k dispozici žádná data, hodnota je null

          • cost
            Typ: number | null

            poplatek za reklamu
            částka, která bude účtována za zobrazování reklamy v zadaném období
            pokud nejsou k dispozici žádná data, hodnota je null

          • ctr
            Typ: number | null Formát: double

            předpokládaná míra prokliku (CTR) reklamy
            počet kliknutí, která má reklama získat, vydělený počtem zobrazení reklamy;
            Poznámka: parametr je zastaralý, hodnota je vždy null

          • date_interval
            Typ: string | null

            interval data prognózy v poli POST

          • impressions
            Typ: integer | null

            předpokládaný počet zobrazení reklamy
            počet zobrazení, která má reklama získat v zadaném období
            Poznámka: parametr je zastaralý, hodnota je vždy null

          • keyword
            Typ: string | null

            klíčové slovo v poli POST
            metriky se poskytují pro všechna klíčová slova zadaná v poli POST

          • 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

          • match
            Typ: string | null

            typ shody klíčových slov
            může nabývat následujících hodnot: exact, broad, phrase

          • search_partners
            Typ: boolean | null

            zahrnout partnery vyhledávání Google
            hodnota je vždy 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 get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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,
          "location_code": null,
          "language_code": null,
          "date_interval": null,
          "search_partners": null,
          "bid": null,
          "match": null,
          "impressions": null,
          "ctr": null,
          "average_cpc": null,
          "cost": null,
          "clicks": null
        }
      ]
    }
  ]
}

Úspěšná operace

Get ‘Ads Traffic By Keywords’ Results by id