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

Vytváření úloh live ‘DataForSEO Trends Subregion Interests’

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 Trends Subregion Interests’

​

Kde se zájem o klíčové slovo koncentruje, rozdělený podle subregionů v rámci location_code. 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. Pokud vás zajímá kdo, a ne kde, použijte post_dataforseo_keywords_trends_demography_live.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.0024.
  • 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, ve výchozím nastavení se použije aktuální den a měsíc předchozího roku
      minimální hodnota pro typ web: 2004-01-01
      minimální hodnota pro ostatní typy: 2008-01-01
      formát data: "yyyy-mm-dd"
      příklad:
      "2019-01-15"

    • date_to
      Typ: string | null

      koncové datum časového rozsahu
      volitelné pole
      pokud toto pole nezadáte, ve výchozím nastavení se použije dnešní datum
      formát data: "yyyy-mm-dd"
      příklad:
      "2019-01-15"

    • keywords
      Typ: array string[]

      keywords
      povinné pole
      maximální počet klíčových slov, která můžete zadat: 5
      vyhněte se symbolům a speciálním znakům (např. symbolům UTF, emoji);
      pokud zadáte nelatinské znaky, získáte data pro země, kde se používají

      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

    • location_code
      Typ: integer | null

      kód lokality vyhledávače
      volitelné pole
      pokud toto pole nepoužijete, obdržíte globální výsledky
      pokud toto pole použijete, nemusíte zadávat location_name
      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/dataforseo_trends/locations
      mějte na paměti, že data budou poskytnuta pro zemi, do které patří zadaný location_code;
      příklad:
      2840

    • location_name
      Typ: string | null

      úplný název lokality vyhledávače
      volitelné pole
      pokud toto pole nepoužijete, obdržíte globální výsledky
      pokud toto pole použijete, nemusíte zadávat location_code
      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/dataforseo_trends/locations
      mějte na paměti, že data budou poskytnuta pro zemi, do které patří zadaný location_name;
      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

    • time_range
      Typ: string | null

      přednastavené časové rozsahy
      volitelné pole
      pokud zadáte parametry date_from nebo date_to, bude toto pole při nastavování úlohy ignorováno
      možné hodnoty pro všechny parametry type:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      Typ: string | null

      typ prvku

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

          • datetime
            Typ: string | null

            datum a čas přijetí výsledku
            ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
            příklad:
            2019-11-15 12:57:46 +00:00

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

            obsahuje popularitu klíčových slov a související data

            • Typ: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                • Typ: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                  • type
                    Diskriminátor
                    Typ: string | null

                    typ prvku

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

                    data o popularitě klíčových slov v subregionech pro každý zadaný výraz

                    • keyword
                      Typ: string | null

                      relevantní klíčové slovo
                      data obsažená v prvku values vycházejí z tohoto klíčového slova

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

                      obsahuje údaje o relativní popularitě klíčových slov podle země nebo regionu

                      • geo_id
                        Typ: string | null

                        identifikátor lokality
                        toto pole můžete použít k párování získaných výsledků s parametry lokality zadanými v požadavku
                        úplný seznam dostupných lokalit s jejich geo_id najdete zde nebo samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        příklad:
                        US-NY

                      • geo_name
                        Typ: string | null

                        název lokality
                        toto pole můžete použít k párování získaných výsledků s parametry lokality zadanými v požadavku
                        úplný seznam dostupných lokalit s jejich geo_name najdete zde nebo samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        příklad:
                        Andorra

                      • value
                        Typ: integer | null

                        relativní míra popularity klíčového slova v dané lokalitě
                        představuje míru popularity klíčového slova specifickou pro lokalitu v zadaném časovém rozsahu;
                        pomocí této value můžete zjistit, jak populární je klíčové slovo v jedné lokalitě ve srovnání s jinou lokalitou;
                        výpočet: určíme nejvyšší hodnotu popularity relevantního klíčového slova ve všech lokalitách a poté všechny ostatní hodnoty vyjádříme jako procento této nejvyšší hodnoty (100);
                        hodnota 100 je nejvyšší popularita výrazu
                        hodnota 50 znamená, že výraz je o polovinu méně populární
                        hodnota 0 znamená, že pro tento výraz nebylo dost dat

                  • interests_comparison
                    Typ: object | null · Response36Afe1097B20_InterestsComparison

                    porovnání dat o popularitě klíčových slov v subregionech pro zadané parametry
                    pokud zadáte jedno klíčové slovo, hodnota bude null

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

                      míry popularity klíčových slov ve všech lokalitách
                      hodnoty v tomto poli představují procenta vůči maximální hodnotě ve všech lokalitách

                      • geo_id
                        Typ: string | null

                        identifikátor lokality
                        toto pole můžete použít k párování získaných výsledků s parametry lokality zadanými v požadavku
                        úplný seznam dostupných lokalit s jejich geo_id najdete zde nebo samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        příklad:
                        US-NY

                      • geo_name
                        Typ: string | null

                        název lokality
                        toto pole můžete použít k párování získaných výsledků s parametry lokality zadanými v požadavku
                        úplný seznam dostupných lokalit s jejich geo_name najdete zde nebo samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        příklad:
                        Andorra

                      • values
                        Typ: array (string | null)[] | null

                        obsahuje údaje o relativní popularitě klíčových slov podle země nebo regionu

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

                      obsahuje popularitu klíčových slov a související data

                      • geo_id
                        Typ: string | null

                        identifikátor lokality
                        toto pole můžete použít k párování získaných výsledků s parametry lokality zadanými v požadavku
                        úplný seznam dostupných lokalit s jejich geo_id najdete zde nebo samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        příklad:
                        US-NY

                      • geo_name
                        Typ: string | null

                        název lokality
                        toto pole můžete použít k párování získaných výsledků s parametry lokality zadanými v požadavku
                        úplný seznam dostupných lokalit s jejich geo_name najdete zde nebo samostatným požadavkem na https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        příklad:
                        Andorra

                      • values
                        Typ: array (string | null)[] | null

                        obsahuje údaje o relativní popularitě klíčových slov podle země nebo regionu

                  • keywords
                    Typ: array (string | null)[] | null

                    klíčová slova v poli POST

                  • position
                    Typ: integer | null

                    zarovnání prvku
                    může nabývat následujících hodnot: 1, 2, 3, 4 atd.

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

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

          • keywords
            Typ: array (string | null)[] | null

            klíčová slova 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

          • type
            Typ: string | null

            typ prvku

        • 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/dataforseo_trends/subregion_interests/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Setting Live ‘DataForSEO Trends Subregion Interests’ Tasks