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

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

​

Zařadí úlohu hledanosti Bing do fronty a vrátí id úlohy. 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čtěte pomocí get_dataforseo_keywords_bing_search_volume_fetch.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.06.
  • 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
      pokud toto pole nezadáte, data budou poskytnuta za posledních 12 měsíců
      minimální hodnota: 24 měsíců od dnešního data
      pokud koncový bod Status vrátí false v poli actual_data, date_from lze nastavit na předminulý měsíc a dřívější;
      pokud koncový bod Status vrátí true v poli actual_data, date_from lze nastavit na poslední měsíc a dřívější;
      formát data: "yyyy-mm-dd"
      příklad:
      "2020-01-01"

      Poznámka: nedoporučujeme používat vlastní časový rozsah pro data z posledního roku

    • date_to
      Typ: string | null

      koncové datum časového rozsahu
      volitelné pole
      pokud toto pole nezadáte, data budou poskytnuta za posledních 12 měsíců;
      minimální hodnota: dva roky zpět od dnešního data;
      maximální hodnota: jeden měsíc od dnešního data;
      poznámka: nedoporučujeme používat vlastní časový rozsah pro data z posledního roku;
      formát data: "yyyy-mm-dd"
      příklad:
      "2020-03-15"

      Poznámka: nedoporučujeme používat vlastní časový rozsah pro data z posledního roku

    • 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: all, mobile, desktop, tablet
      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ě: 100
      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
      pokud toto pole použijete, nemusíte zadávat language_name
      podporované jazyky:
      en, fr, de

    • 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
      podporované jazyky:
      English, French, German

    • 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 vyhledávačů s jejich location_code získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/locations
      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 vyhledávače s jejich location_name získáte odesláním samostatného požadavku na https://api.dataforseo.com/v3/keywords_data/bing/locations
      příklad:
      London,England,United Kingdom

    • pingback_url
      Typ: string | null

      URL oznámení o dokončení úlohy
      volitelné pole
      po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL
      řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty
      příklad:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Poznámka: speciální znaky v pingback_url budou kódovány v URL;
      mimo jiné znak # bude zakódován jako %23

      další informace najdete v našem centru nápovědy

    • postback_url
      Typ: string | null

      URL pro odesílání výsledků úlohy
      volitelné pole
      po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátu gzip na zadanou postback_url
      řetězec ‘$id’ můžete použít jako proměnnou $id a ‘$tag’ jako proměnnou $tag kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.
      příklad:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Poznámka: speciální znaky v postback_url budou kódovány v URL;
      mj. znak # bude zakódován jako %23

      další informace najdete v Centru nápovědy

    • search_partners
      Typ: boolean | null

      typ partnerů vyhledávání Bing
      volitelné pole
      pokud zadáte true, výsledky budou doručeny pro vlastní, provozované a syndikované sítě v rámci Bing, Yahoo, AOL a partnerských webů, které hostují vyhledávání Bing, AOL a Yahoo.
      výchozí hodnota: false - výsledky se vracejí pro vyhledávací sítě Bing, AOL a Yahoo

    • sort_by
      Typ: string | null

      parametry řazení výsledků
      volitelné pole
      Tyto parametry použijte k seřazení výsledků podle search_volume, cpc, competition nebo relevance v sestupném pořadí
      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 objektu data odpovědi

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_KeywordsDataBingSearchVolumeTaskPostResponseInfo
    • 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_KeywordsDataBingSearchVolumeTaskPostTaskInfo
        • 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: object | null

          pole výsledků
          v tomto případě bude hodnota null

        • 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/search_volume/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_name": "English",
    "keywords": [
      "average page rpm adsense",
      "adsense blank ads how long",
      "leads and prospects"
    ]
  }
]'

{
  "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": null
    }
  ]
}

Úspěšná operace

Setting ‘Search Volume’ Tasks