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

Vytváření úloh live ‘Bing Keyword Performance’

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 ‘Bing Keyword Performance’

​

Jak si seznam keywords vede v Bing Ads pro daný device a typ match. ⚠️ language_name je povinné a jeho nepřítomnost je hlášena jako Invalid Field: 'language_name' uvnitř HTTP 200 – zpráva znamená jak chybějící, tak chybnou hodnotu. 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. Platné páry pocházejí z get_dataforseo_keywords_bing_kw_performance_locales. 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)[]
    • device
      Typ: string | null

      typ zařízení
      volitelné pole
      toto pole zadejte, pokud chcete získat data pro konkrétní typ zařízení. Možné hodnoty: desktop, mobile, tablet, all
      výchozí hodnota: all

    • keywords
      Typ: array string[]

      klíčová slova
      povinné pole
      Maximální počet klíčových slov, která můžete zadat: 1000
      Maximální počet znaků v každém klíčovém slově: 80
      Maximální počet slov v každé klíčové frázi: 10
      zadaná klíčová slova se převedou na malá písmena, data budou vrácena v samostatném poli

      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 lokalit a jazyků získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      příklad:
      "en"

    • language_name
      Typ: string

      ú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 lokalit a jazyků získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      příklad:
      English

    • location_code
      Typ: integer

      kód lokality vyhledávače
      povinné pole, pokud nezadáte location_name nebo location_coordinate
      pokud toto pole použijete, nemusíte zadávat location_name ani location_coordinate
      seznam dostupných lokalit a jazyků získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      příklad:
      2840

    • location_coordinate
      Typ: string

      GPS souřadnice lokality
      povinné pole, pokud nezadáte location_name nebo location_code
      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 vrácena pro zemi, do které zadané souřadnice patří
      příklad:
      52.6178549,-155.352142

    • location_name
      Typ: string

      úplný název lokality vyhledávače
      povinné pole, pokud nezadáte location_code nebo location_coordinate
      pokud toto pole použijete, nemusíte zadávat location_code ani location_coordinate
      seznam dostupných lokalit a jazyků získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/keyword_performance/locations_and_languages
      příklad:
      "United States"

    • match
      Typ: string | null

      typ shody klíčových slov
      volitelné pole
      může nabývat následujících hodnot:
      aggregate vrací data napříč všemi typy shody;
      broad vrací data pro všechny dotazy uživatelů obsahující zadané klíčové slovo v libovolném pořadí slov;
      phrase vrací data pro všechny dotazy uživatelů obsahující zadané klíčové slovo ve stejném pořadí slov;
      exact vrací data pro dotaz uživatele, který odpovídá zadanému klíčovému slovu;Poznámka: ve výchozím nastavení se použije typ shody aggregate

    • 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_KeywordsDataBingKeywordPerformanceLiveResponseInfo
    • 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_KeywordsDataBingKeywordPerformanceLiveTaskInfo
        • 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ů

          • keyword
            Typ: string | null

            klíčové slovo v poli POST

          • keyword_kpi
            Typ: object | null · Response36Afe1097B20_KeywordKpi

            objekt obsahující metriky klíčového slova
            pokud nejsou k dispozici žádná data, hodnota je null

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

              data klíčového slova agregovaná pro stolní zařízení
              pokud nejsou k dispozici žádná data, hodnota je null

              • ad_position
                Typ: string | null

                představuje pozici příslušné reklamy v SERP
                může nabývat následujících hodnot:
                FirstPage1: první reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage2: druhá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage3: třetí reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage4: čtvrtá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage5: pátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage6: šestá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage7: sedmá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage8: osmá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage9: devátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage10: desátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                MainLine1: první reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine2: druhá reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine3: třetí reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine4: čtvrtá reklama zobrazená v horní části stránky výsledků vyhledávání

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

                průměrná nabídka klíčového slova

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

                průměrná cena za kliknutí, USD
                vypočítá se vydělením nákladů na všechna kliknutí počtem kliknutí

              • clicks
                Typ: integer | null

                kliknutí na reklamu
                počet kliknutí, která klíčové slovo a typ shody vygenerovaly za poslední měsíc

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

                míra prokliku v procentech
                vypočítá se vydělením počtu kliknutí počtem zobrazení a vynásobením výsledku 100

              • impressions
                Typ: integer | null

                zobrazení reklamy
                počet zobrazení, která klíčové slovo a typ shody vygenerovaly za poslední měsíc

              • total_cost
                Typ: number | null Formát: int64

                celkové náklady na reklamu, USD
                náklady na použití daného klíčového slova a typu shody za poslední měsíc

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

              data klíčového slova agregovaná pro mobilní zařízení
              pokud nejsou k dispozici žádná data, hodnota je null

              • ad_position
                Typ: string | null

                představuje pozici příslušné reklamy v SERP
                může nabývat následujících hodnot:
                FirstPage1: první reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage2: druhá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage3: třetí reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage4: čtvrtá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage5: pátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage6: šestá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage7: sedmá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage8: osmá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage9: devátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage10: desátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                MainLine1: první reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine2: druhá reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine3: třetí reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine4: čtvrtá reklama zobrazená v horní části stránky výsledků vyhledávání

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

                průměrná nabídka klíčového slova

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

                průměrná cena za kliknutí, USD
                vypočítá se vydělením nákladů na všechna kliknutí počtem kliknutí

              • clicks
                Typ: integer | null

                kliknutí na reklamu
                počet kliknutí, která klíčové slovo a typ shody vygenerovaly za poslední měsíc

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

                míra prokliku v procentech
                vypočítá se vydělením počtu kliknutí počtem zobrazení a vynásobením výsledku 100

              • impressions
                Typ: integer | null

                zobrazení reklamy
                počet zobrazení, která klíčové slovo a typ shody vygenerovaly za poslední měsíc

              • total_cost
                Typ: number | null Formát: int64

                celkové náklady na reklamu, USD
                náklady na použití daného klíčového slova a typu shody za poslední měsíc

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

              data klíčového slova agregovaná pro tablety
              pokud nejsou k dispozici žádná data, hodnota je null

              • ad_position
                Typ: string | null

                představuje pozici příslušné reklamy v SERP
                může nabývat následujících hodnot:
                FirstPage1: první reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage2: druhá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage3: třetí reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage4: čtvrtá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage5: pátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage6: šestá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage7: sedmá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage8: osmá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage9: devátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                FirstPage10: desátá reklama zobrazená na pravé straně první stránky výsledků vyhledávání
                MainLine1: první reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine2: druhá reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine3: třetí reklama zobrazená v horní části stránky výsledků vyhledávání
                MainLine4: čtvrtá reklama zobrazená v horní části stránky výsledků vyhledávání

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

                průměrná nabídka klíčového slova

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

                průměrná cena za kliknutí, USD
                vypočítá se vydělením nákladů na všechna kliknutí počtem kliknutí

              • clicks
                Typ: integer | null

                kliknutí na reklamu
                počet kliknutí, která klíčové slovo a typ shody vygenerovaly za poslední měsíc

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

                míra prokliku v procentech
                vypočítá se vydělením počtu kliknutí počtem zobrazení a vynásobením výsledku 100

              • impressions
                Typ: integer | null

                zobrazení reklamy
                počet zobrazení, která klíčové slovo a typ shody vygenerovaly za poslední měsíc

              • total_cost
                Typ: number | null Formát: int64

                celkové náklady na reklamu, USD
                náklady na použití daného klíčového slova a typu shody za poslední měsíc

          • 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

          • month
            Typ: integer | null

            udává měsíc, za který jsou data poskytnuta
            příklad:
            10

          • year
            Typ: integer | null

            udává rok, za který jsou data poskytnuta
            příklad:
            2020

        • 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/bing/keyword_performance/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "keywords": [
      "dataforseo",
      "seo",
      "ranking"
    ]
  }
]'

{
  "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,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}

Úspěšná operace

Setting Live ‘Bing Keyword Performance’ Tasks