v0.2.0-beta

OpenAPI 3.1.0

Google Autocomplete naživo – pokročilé

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

post/v1/beta/dataforseo/serp/google/autocomplete/live/advanced

Google Autocomplete naživo – pokročilé

Synchronně vrací návrhy, které Google nabízí při psaní dotazu. 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; regular použijte, když záleží jen na pořadí, a html jen pro kontrolu, co parser vynechal. 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.02.
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)[]
- client
  Typ: string | null
  
  vyhledávací klient pro automatické doplňování
  
  volitelné pole
  
  výsledky automatického doplňování se mohou lišit v závislosti na vyhledávacím klientovi;
  
  možné hodnoty:
  
  chrome — používá se, když je hledání Google otevřeno v prohlížeči Google Chrome;
  
  chrome-omni — používá se na adresním řádku v Chrome;
  
  gws-wiz — používá se na domovské stránce hledání Google;
  
  gws-wiz-serp — používá se na stránce výsledků hledání Google;
  
  safari — používá se, když je hledání Google otevřeno v prohlížeči Safari;
  
  firefox — používá se, když je hledání Google otevřeno v prohlížeči Firefox;
  
  psy-ab — může se používat, když je hledání Google otevřeno v prohlížeči Google Chrome;
  
  toolbar — vrací XML;
  
  youtube — vrací JSONP;
  
  gws-wiz-local — používá se v místním hledání Google;
  
  img — používá se v hledání obrázků Google;
  
  products-cc — používá se v hledání Google Shopping
- cursor_pointer
  Typ: integer | null
  
  ukazatel kurzoru na panelu hledání
  
  volitelné pole
  
  vodorovná číselná pozice kurzoru v rámci klíčového slova na panelu hledání;
  
  změnou pozice kurzoru získáte pro stejné výchozí klíčové slovo různé návrhy automatického doplňování;
  
  minimální hodnota: 0
  
  výchozí hodnota: číslo posledního znaku zadaného keyword
  
  příklad:
  
  |which query are s - "cursor_pointer": 0
  
  which query is s| - "cursor_pointer": 16
  
  which que|ry is s - "cursor_pointer": 9
- keyword
  Typ: string
  
  klíčové slovo
  
  povinné pole
  
  do pole keyword můžete zadat až 700 znaků
  
  všechny výskyty %## 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 tomto č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/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 jazyků vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/google/languages
  
  příklad:
  
  English
- location_code
  Typ: integer
  
  kód lokality vyhledávače
  
  povinné pole, pokud nezadáte 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/serp/google/locations
  
  příklad:
  
  2840
- location_name
  Typ: string
  
  úplný název lokality vyhledávače
  
  povinné pole, pokud nezadáte location_code
  
  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/serp/google/autocomplete/locations
  
  příklad:
  
  London,England,United Kingdom
- 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_SerpGoogleAutocompleteLiveAdvancedResponseInfo
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_SerpGoogleAutocompleteLiveAdvancedTaskInfo
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:
autocomplete

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

položky prvku

highlighted
Typ: array (string | null)[] | null

klíčová slova zvýrazněná v automatickém doplňování
obsahuje seznam návrhů automatického doplňování Google, které jsou zvýrazněny ve vyhledávacím poli;
Poznámka: pole je dostupné pouze pro následující client:
gws-wiz
psy-ab
gws-wiz-local

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í

relevance
Typ: integer | null

relevance navrhovaného klíčového slova
představuje relevanci návrhu automatického doplňování vůči cílovému klíčovému slovu
může nabývat hodnot od 500 do 2000
čím vyšší hodnota, tím relevantnější návrh
Poznámka: dostupné pouze pro následující client:
chrome/chrome-omni

search_query_url
Typ: string | null

URL výsledků vyhledávání
URL výsledků vyhledávání relevantních pro návrh automatického doplňování Google

suggestion
Typ: string | null

návrh klíčového slova automatického doplňování Google

suggestion_type
Typ: string | null

typ návrhu automatického doplňování Google
Poznámka: dostupné pouze pro následující client:
chrome/chrome-omni

thumbnail_url
Typ: string | null

URL obrázku miniatury
URL obrázku miniatury návrhu automatického doplňování Google
Poznámka: dostupné pouze pro následující client:
gws-wiz
gws-wiz-serp

type
Typ: string | null

typ 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 %## (znak plus '+' bude dekódován jako mezera)

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í

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ě se bude rovnat 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

post/v1/beta/dataforseo/serp/google/autocomplete/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/autocomplete/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "client": "gws-wiz-serp"
  }
]'

Zobrazit schéma

{
  "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,
              "relevance": null,
              "suggestion": null,
              "suggestion_type": null,
              "search_query_url": null,
              "thumbnail_url": null,
              "highlighted": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Google Autocomplete naživo – pokročilé

OvěřováníRequired

DataForSEO

Google Autocomplete naživo – pokročilé

Cenová reference