DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Živý Google Organic SERP Advanced
Synchronně vrací výsledky v pořadí pro klíčové slovo v Google. 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.0175.
- 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.
- Typ: array (object | null)[]
- browserTyp: integer | null
_screen _height 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 androidu; 812 pro mobile na iOS; Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true
- browserTyp: integer | null
_screen _resolution _ratio 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 androidu; 3 pro mobile na iOS; Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true
- browserTyp: integer | null Formát: int64
_screen _width šíř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 androidu; 375 pro mobile na iOS; Poznámka: pro použití tohoto parametru nastavte calculate_rectangles na true
- calculateTyp: boolean | null
_rectangles 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: za použití tohoto parametru bude účtován příplatek $0.002
- depthTyp: integer | null
hloubka parsování volitelné pole počet výsledků v SERP výchozí hodnota: 10 maximální hodnota: 200 Váš účet bude účtován za každý SERP obsahující až 10 výsledků; Nastavení hloubky nad 10 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 10 výsledků; Náklady lze vypočítat na stránce Ceny.
- deviceTyp: 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
- findTyp: array string[] | null
_targets _in typy prvků SERP ke kontrole cílů volitelné pole pro povolení tohoto parametru musí být povolen také stop_crawl_on_match určuje, které typy prvků SERP mají být kontrolovány na shody cílů pokud není zadáno, všechny prvky první úrovně s poli url a domain jsou kontrolovány na cíle možné hodnoty: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Poznámka: nesmí obsahovat stejné typy prvků jako ignore_targets_in příklad: "find_targets_in": ["organic", "featured_snippet"] více o tomto parametru najdete v našem Centru nápovědy
- groupTyp: boolean | null
_organic _results zobrazit související výsledky volitelné pole pokud je nastaveno na true, prvek related_result v odpovědi bude poskytnut jako úryvek nadřazeného organického výsledku; pokud je nastaveno na false, prvek related_result bude poskytnut jako samostatný organický výsledek; výchozí hodnota: true
- ignoreTyp: array string[] | null
_targets _in typy prvků SERP k vyloučení z hledání cílů volitelné pole pro povolení tohoto parametru musí být povolen také stop_crawl_on_match určuje, které typy prvků SERP mají být při hledání shod cílů vyloučeny možné hodnoty: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Poznámka: nesmí obsahovat stejné typy prvků jako find_targets_in příklad: "ignore_targets_in": ["paid", "images"] více o tomto parametru najdete v našem Centru nápovědy
- keywordTyp: string
klíčové slovo povinné pole v poli 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 použít znak „%” v poli keyword, zadejte jej jako „%25”; pokud potřebujete použít znak „+” v poli keyword, zadejte jej jako „%2B”; pokud toto pole obsahuje parametry jako „allinanchor:”, „allintext:”, „allintitle:”, „allinurl:”, „cache:”, „define:”, „definition:”, „filetype:”, „id:”, „inanchor:”, „info:”, „intext:”, „intitle:”, „inurl:”, „link:”, „site:”, poplatek za úlohu bude vynásoben 5 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
- languageTyp: string | null
_code kód jazyka vyhledávače volitelné pole, pokud zadá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
- languageTyp: string | null
_name úplný název jazyka vyhledávače volitelné pole, pokud zadá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
- loadTyp: boolean | null
_async _ai _overview načíst asynchronní přehled AI volitelné pole nastavte na true, abyste získali položky ai_overview v SERP, i když se načítají asynchronně; pokud je nastaveno na false, získáte položky ai_overview pouze z mezipaměti; výchozí hodnota: false Poznámka: za použití tohoto parametru bude účtován příplatek $0.002; pokud prvek chybí nebo obsahuje "asynchronous_ai_overview": false, všechny dodatečné poplatky vám budou vráceny na zůstatek účtu
- locationTyp: integer | null
_code 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 příklad: 2840
- locationTyp: string | null
_coordinate GPS souřadnice lokality volitelné pole, pokud zadá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,radius" maximální počet desetinných míst pro "latitude" a "longitude": 7 minimální hodnota pro "radius": 199 (mm) maximální hodnota pro "radius": 199999 (mm) příklad: 53.476225,-2.243572,200
- locationTyp: string | null
_name ú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 příklad: London,England,United Kingdom
- matchTyp: string | null
_type typ shody cíle povinné pole, pokud je zadáno stop_crawl_on_match typ shody pro match_value možné hodnoty: domain – konkrétní doména nebo subdoména with_subdomains – hlavní doména a subdomény wildcard – vzor se zástupnými znaky
- matchTyp: string | null
_value cílová doména, subdoména nebo hodnota se zástupnými znaky povinné pole, pokud je zadáno stop_crawl_on_match zadejte cílovou doménu, subdoménu nebo hodnotu se zástupnými znaky; Poznámka: doménu nebo subdoménu je nutné zadat bez protokolu požadavku; příklad: "match_value": "dataforseo.com", "match_value": "/blog/post-*"
- maxTyp: integer | null
_crawl _pages limit procházení stránek volitelné pole počet stránek výsledků vyhledávání k procházení maximální hodnota: 100 Poznámka: za každou procházenou stránku bude účtován poplatek (10 organických výsledků na stránku); další informace o cenách najdete na stránce Ceny; Poznámka#2: parametry max_crawl_pages a depth se vzájemně doplňují; další informace najdete v našem Centru nápovědy
- osTyp: 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
- peopleTyp: integer | null
_also _ask _click _depth kliknutí na odpovídající prvek volitelné pole zadejte hloubku kliknutí na prvek people_also_ask pro získání dalších položek people_also_ask_element; Poznámka: váš účet bude účtován dodatečně $0.00015 za každé kliknutí; pokud prvek chybí nebo provedeme méně kliknutí, než jste zadali, všechny dodatečné poplatky vám budou vráceny na zůstatek účtu možné hodnoty: od 1 do 4
- removeTyp: array string[] | null
_from _url odebrání konkrétních parametrů z URL volitelné pole pomocí tohoto pole můžete zadat až 10 parametrů, které se mají odebrat z URL ve výsledku příklad: "remove_from_url": ["srsltid"] Poznámka: pokud je zadáno pole target, zadané parametry URL budou před vyhledáváním odebrány
- seTyp: string | null
_domain doména vyhledávače volitelné pole relevantní doménu vyhledávače vybíráme automaticky podle zadané lokality a jazyka v tomto poli však můžete nastavit vlastní doménu vyhledávače příklad: google.co.uk, google.com.au, google.de atd.
- searchTyp: string | null
_param další parametry vyhledávacího dotazu volitelné pole seznam dostupných parametrů a další podrobnosti najdete zde Poznámka: následující parametry vyhledávače nejsou podporovány a budou automaticky zrušeny, pokud jsou zadány: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopTyp: array (object | null)[] | null
_crawl _on _match pole cílových hodnot pro zastavení procházení volitelné pole pokud je zadáno, odpověď bude obsahovat výsledky SERP až do zadané hodnoty match_value včetně; v tomto poli můžete zadat až 10 cílových hodnot příklad: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] další informace o tomto parametru najdete v našem Centru nápovědy — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Váš účet bude účtován za každý SERP procházený přes zadané cíle
- matchTyp: string | null
_type typ shody cíle povinné pole, pokud je zadáno stop_crawl_on_match; typ shody pro match_value možné hodnoty: domain, with_subdomains, wildcard
- matchTyp: string | null
_value cílová doména nebo hodnota se zástupným znakem povinné pole, pokud je zadáno stop_crawl_on_match; zadejte cílovou doménu nebo hodnotu se zástupným znakem; Poznámka: název domény je nutné zadat bez protokolu požadavku; příklad: dataforseo.com
- tagTyp: string | null
Uživatelem definovaný identifikátor úlohy. Volitelné pole. Limit znaků je 255. Pomocí tohoto parametru můžete úlohu identifikovat a spárovat ji s výsledkem. Zadanou hodnotu tag najdete v objektu data odpovědi.
- targetTyp: string | null
cílová doména, subdoména nebo webová stránka, pro kterou se mají získat výsledky volitelné pole doménu nebo subdoménu je nutné zadat bez https:// a www. mějte na paměti, že výsledky úloh specifických pro target budou obsahovat pouze prvky SERP obsahující řetězec url; můžete také použít zástupný znak (‘’) k určení vzoru vyhledávání v SERP a zúžení výsledků; příklady: example.com - vrací výsledky pro domovskou stránku webu s URL, jako jsou https://example.com, https://www.example.com/ nebo https://example.com/; example.com - vrací výsledky pro doménu včetně všech jejích stránek; example.com - vrací výsledky pro celou doménu včetně všech jejích stránek a subdomén; example.com - vrací výsledky pro domovskou stránku bez ohledu na subdoménu, například https://en.example.com; example.com/example-page - vrací výsledky pro přesnou URL; example.com/example-page - vrací výsledky pro všechny URL domény začínající zadaným řetězcem
- targetTyp: string | null
_search _mode režim porovnávání cílů volitelné pole pro povolení tohoto parametru musí být povolen také stop_crawl_on_match určuje, jak má procházení přestat, když je v stop_crawl_on_match zadáno více cílů možné hodnoty: all, any all – procházení se zastaví pouze tehdy, když jsou nalezeny všechny zadané cíle any – procházení se zastaví, když je nalezen jakýkoli jeden cíl výchozí hodnota: any více o tomto parametru najdete v našem Centru nápovědy
- urlTyp: string | null
přímá URL vyhledávacího dotazu volitelné pole můžete zadat přímou URL a my ji rozebereme do potřebných polí. Upozorňujeme, že tato metoda je pro naše API nejnáročnější na zpracování a vyžaduje zadání přesného jazyka a lokality v URL. Ve většině případů tuto metodu nedoporučujeme. příklad: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Poznámka: následující parametry vyhledávače nejsou podporovány a budou automaticky zrušeny, pokud jsou zadány: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- checkTyp: string | null
_url přímá adresa URL na výsledky vyhledávání. Můžete ji použít k ověření, že jsme poskytli přesné výsledky
- datetimeTyp: 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
- itemTyp: array (string | null)[] | null
_types 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: answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
- itemsTyp: array (object | null)[] | null
položky prvku
- pageTyp: integer | null
číslo stránky výsledků vyhledávání
udává číslo stránky SERP, na které se prvek nachází - positionTyp: string | null
zarovnání prvku v SERP
může nabývat následujících hodnot:left,right - rectangleTyp: object | null · Response36Afe1097B20_AiModeRectangleInfo
parametry obdélníku
obsahuje kartézské souřadnice a rozměry v pixelech úryvku výsledku v SERP
rovná senull, pokudcalculate_rectanglesv požadavku POST není nastaveno natrue- heightTyp: number | null Formát: double
výška prvku v pixelech
- widthTyp: number | null Formát: double
šířka prvku v pixelech
- xTyp: 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
- yTyp: 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
- typeTyp: string | null
typ prvku
- xpathTyp: string | null
XPath prvku
- itemsTyp: integer | null Formát: int64
_count Počet výsledků vrácených v poli items.
- keywordTyp: string | null
klíčové slovo přijaté v poli POST klíčové slovo se vrací s dekódovaným %## (znak „+” bude dekódován na znak mezery)
- languageTyp: string | null
_code Kód jazyka v poli POST.
- locationTyp: integer | null
_code Kód lokality v poli POST.
- pagesTyp: integer | null Formát: int64
_count celkový počet načtených stránek výsledků vyhledávání celkový počet načtených SERP ve výsledku
- refinementTyp: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips čipy pro upřesnění vyhledávání
- itemsTyp: array (object | null)[] | null
položky prvku
- domainTyp: string | null
doména v SERP
- optionsTyp: array (object | null)[] | null
další možnosti upřesnění vyhledávání
- domainTyp: string | null
doména v SERP
- titleTyp: string | null
název prvku
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL vyhledávání s parametry upřesnění
- titleTyp: string | null
název prvku
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL vyhledávání s parametry upřesnění
- typeTyp: string | null
typ prvku
- xpathTyp: string | null
XPath prvku
- seTyp: string | null
_domain doména vyhledávače v poli POST
- seTyp: integer | null Formát: int64
_results _count celkový počet výsledků v SERP
- spellTyp: 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
- keywordTyp: string | null
klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo
- typeTyp: 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
- typeTyp: string | null
typ prvku
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code 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
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/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",
"calculate_rectangles": true
}
]'
{
"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,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}