Data API / DataForSEO / SERP

Live Google Organic SERP Regular

Returns the ranked results for a keyword on Google, synchronously. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

keywordstringОбязательный
Keyword to search for
location_namestringНеобязательный
Full name of search engine location
location_codeintegerНеобязательный
Search engine location code
location_coordinatestringНеобязательный
GPS coordinates of a location
language_namestringНеобязательный
Full name of search engine language
language_codestringНеобязательный
Search engine language code
devicestringНеобязательный
Device type: desktop or mobile
osstringНеобязательный
Device operating system
depthintegerНеобязательный
Parsing depth, default 100, max 700
max_crawl_pagesintegerНеобязательный
Page crawl limit, max 100
tagstringНеобязательный
User-defined task identifier

Пример запроса

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/regular" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "device": "<string>",
  "os": "<string>"
}'

Ответ

Поля ответа

versionstringНеобязательный
API version
status_codeintegerНеобязательный
General status code
status_messagestringНеобязательный
General informational message
timestringНеобязательный
Execution time
costnumberНеобязательный
Request cost in USD
tasks_countintegerНеобязательный
Number of tasks returned
tasks_errorintegerНеобязательный
Number of tasks returned with an error
tasksstringНеобязательный
Array of live task objects
idstringНеобязательный
Task identifier
resultstringНеобязательный
Live SERP regular results