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

Živý Google AI Mode SERP

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

Živý Google AI Mode SERP

​

Synchronně vrací odpověď Google AI Mode pro dotaz včetně zdrojů, které v Google cituje. Vrací keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count a items. advanced je výchozí volba; vezměte regular, když záleží jen na seznamu pořadí, a html jen pro kontrolu, co parser zahodil. 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.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.004.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již 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)[]
    • browser_screen_height
      Typ: integer | null

      výška obrazovky prohlížeče

      volitelné pole

      můžete nastavit vlastní výšku obrazovky prohlížeče pro výpočet pixelového pořadí pro konkrétní zařízení;

      lze ji zadat v následujícím rozsahu: 240-9999;

      ve výchozím nastavení je parametr nastaven na:

      1080 pro desktop;

      640 pro mobile na android;

      812 pro mobile na iOS;

      Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true

    • browser_screen_resolution_ratio
      Typ: integer | null

      faktor měřítka obrazovky prohlížeče

      volitelné pole

      můžete nastavit vlastní faktor měřítka obrazovky prohlížeče pro výpočet pixelového pořadí pro konkrétní zařízení;

      lze jej zadat v následujícím rozsahu: 0.5-3;

      ve výchozím nastavení je parametr nastaven na:

      1 pro desktop;

      3 pro mobile na android;

      3 pro mobile na iOS;

      Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true

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

      šířka obrazovky prohlížeče

      volitelné pole

      můžete nastavit vlastní šířku obrazovky prohlížeče pro výpočet pixelového pořadí pro konkrétní zařízení;

      lze ji zadat v následujícím rozsahu: 240-9999;

      ve výchozím nastavení je parametr nastaven na:

      1920 pro desktop;

      360 pro mobile na android;

      375 pro mobile na iOS;

      Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true

    • calculate_rectangles
      Typ: boolean | null

      vypočítat pixelové pořadí prvků SERP v rozšířených výsledcích

      volitelné pole

      pixelové pořadí označuje vzdálenost mezi úryvkem výsledku a levým horním rohem obrazovky;

      Další informace najdete v Centru nápovědy>>

      ve výchozím nastavení je parametr nastaven na false

      Poznámka: pokud je nastaveno na true, poplatek za úlohu bude vynásoben 2

    • device
      Typ: string | null

      typ zařízení

      volitelné pole

      vracet výsledky pro určitý typ zařízení

      může nabývat hodnot:desktop, mobile

      výchozí hodnota: desktop

    • keyword
      Typ: string

      klíčové slovo

      povinné pole

      v poli keyword můžete zadat až 700 znaků

      všechny %## budou dekódovány (znak ‘+’ bude dekódován jako mezera)

      pokud potřebujete v keyword použít znak „%“, zadejte jej jako „%25“;

      pokud potřebujete v keyword použít znak „+“, zadejte jej jako „%2B“


      další informace o pravidlech a omezeních polí keyword a keywords v rozhraních API DataForSEO najdete v článku Centra 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;

      seznam dostupných jazyků vyhledávače s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/google/ai_mode/languages

    • 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 jazyků vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/google/ai_mode/languages;

    • 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 nebo 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/serp/google/locations

      Poznámka: seznam zemí, ve kterých je režim AI Mode aktuálně dostupný, najdete na stránce Google Search Help

    • 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 nebo location_code

      parametr location_coordinate je nutné zadat ve formátu "latitude,longitude,zoom"

      pokud není "zoom" zadán, použije se jako výchozí hodnota 9z

      maximální počet desetinných míst pro "latitude" a "longitude": 7

      minimální hodnota pro "zoom": 4z

      maximální hodnota pro "zoom": 18z

      příklad:

      52.6178549,-155.352142,18z

    • 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 nebo 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/serp/google/locations

      Poznámka: seznam zemí, ve kterých je režim AI Mode aktuálně dostupný, najdete na stránce Google Search Help

    • os
      Typ: string | null

      operační systém zařízení

      volitelné pole

      pokud v poli device zadáte desktop, vyberte z následujících hodnot: windows, macos

      výchozí hodnota: windows

      pokud v poli device zadáte mobile, vyberte z následujících hodnot: android, ios

      výchozí hodnota: android

    • tag
      Typ: string | null

      identifikátor úlohy definovaný uživatelem

      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_SerpGoogleAiModeLiveAdvancedResponseInfo
    • 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_SerpGoogleAiModeLiveAdvancedTaskInfo
        • 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ů

          • check_url
            Typ: string | null

            přímá adresa URL na výsledky vyhledávače
            můžete ji použít k ověření, že jsme poskytli přesné výsledky

          • 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

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

            typy výsledků vyhledávání v SERP
            obsahuje typy výsledků vyhledávání (items) nalezených v SERP.
            možné typy položek:
            ai_overview

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

            položky prvku

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

              položky obsažené v prvku

              • position
                Typ: string | null

                zarovnání prvku v SERP
                může nabývat následujících hodnot:
                left, right

              • type
                Typ: string | null

                typ prvku

            • markdown
              Typ: string | null

              obsah prvku ve formátu markdown
              text ai_overview formátovaný v značkovacím jazyce markdown

            • page
              Typ: integer | null

              stránka SERP
              stránka SERP, na které se prvek umisťuje

            • position
              Typ: string | null

              zarovnání prvku v SERP
              může nabývat následujících hodnot:
              left, right

            • rank_absolute
              Typ: integer | null

              absolutní pořadí v SERP
              absolutní pozice mezi všemi prvky v SERP

            • rank_group
              Typ: integer | null

              pořadí skupiny v SERP
              pozice ve skupině prvků se shodnými hodnotami type
              pozice prvků s jinými hodnotami type se v rank_group vynechávají

            • rectangle
              Typ: object | null · Response36Afe1097B20_AiModeRectangleInfo

              parametry obdélníku
              obsahuje kartézské souřadnice a rozměry v pixelech úryvku výsledku v SERP
              rovná se null, pokud calculate_rectangles v požadavku POST není nastaveno na true

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

                výška prvku v pixelech

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

                šířka prvku v pixelech

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

                souřadnice osy x souřadnice osy x levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky

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

                souřadnice osy y souřadnice osy y levého horního rohu úryvku výsledku, přičemž počátkem je levý horní roh obrazovky

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

              doplňkové reference související s položkou
              zahrnuje reference na webové stránky, které mohly být použity ke generování ai_overview

              • domain
                Typ: string | null

                název domény reference

              • position
                Typ: string | null

                zarovnání prvku v SERP
                může nabývat následujících hodnot:
                left, right

              • source
                Typ: string | null

                název nebo titulek zdroje reference

              • text
                Typ: string | null

                text komponenty

              • title
                Typ: string | null

                text kotvy odkazu

              • type
                Typ: string | null

                typ prvku

              • url
                Typ: string | null

                URL odkazu

            • type
              Typ: string | null

              typ prvku

            • xpath
              Typ: string | null

              XPath prvku

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

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

          • keyword
            Typ: string | null

            klíčové slovo přijaté v poli POST
            klíčové slovo se vrací s dekódovaným %## (symbol „+” bude dekódován na znak mezery)

          • language_code
            Typ: string | null

            kód jazyka v poli POST

          • location_code
            Typ: integer | null

            kód lokality v poli POST

          • refinement_chips
            Typ: object | null · Response36Afe1097B20_RefinementChipsInfo

            čipy pro upřesnění vyhledávání
            v tomto případě bude hodnota null

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

              položky prvku

              • domain
                Typ: string | null

                doména v SERP

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

                další možnosti upřesnění vyhledávání

                • domain
                  Typ: string | null

                  doména v SERP

                • title
                  Typ: string | null

                  název prvku

                • type
                  Typ: string | null

                  typ prvku

                • url
                  Typ: string | null

                  URL vyhledávání s parametry upřesnění

              • title
                Typ: string | null

                název prvku

              • type
                Typ: string | null

                typ prvku

              • url
                Typ: string | null

                URL vyhledávání s parametry upřesnění

            • type
              Typ: string | null

              typ prvku

            • xpath
              Typ: string | null

              XPath prvku

          • se_domain
            Typ: string | null

            doména vyhledávače v poli POST

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

            celkový počet výsledků v SERP

          • spell
            Typ: object | null · Response36Afe1097B20_SpellInfo

            automatická oprava vyhledávače
            pokud vyhledávač poskytl výsledky pro opravené klíčové slovo, uvedeme klíčové slovo opravené vyhledávačem a typ automatické opravy;
            v tomto případě bude hodnota null

            • keyword
              Typ: string | null

              klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo

            • type
              Typ: string | null

              typ automatické opravy možné hodnoty: did_you_mean, showing_results_for, no_results_found_for, including_results_for poznámka: Yahoo a Yandex podporují pouze následující typ automatické opravy: including_results_for

          • 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/serp/google/ai_mode/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "what is google ai mode"
  }
]'

{
  "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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "page": null,
              "position": null,
              "xpath": null,
              "markdown": null,
              "items": [
                "[Max Depth Exceeded]"
              ],
              "references": [
                "[Max Depth Exceeded]"
              ],
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Live Google AI Mode SERP