Data API / DataForSEO / SERP

Live Google AI Mode SERP

Returns Google's AI Mode answer for a query, with the sources it cites on Google, synchronously. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. advanced is the default choice; take regular when only the ranked list matters and html only to check what the parser dropped. 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; you can specify up to 700 characters
location_codeintegerНеобязательный
Search engine location code; required if location_name or location_coordinate is not specified
location_namestringНеобязательный
Full name of search engine location; required if location_code or location_coordinate is not specified
location_coordinatestringНеобязательный
GPS coordinates of a location; required if location_name or location_code is not specified
language_namestringНеобязательный
Full name of search engine language; required if language_code is not specified
language_codestringНеобязательный
Search engine language code; required if language_name is not specified
devicestringНеобязательный
Device type: desktop or mobile
calculate_rectanglesbooleanНеобязательный
Enable pixel ranking calculations for elements in SERP
browser_screen_widthintegerНеобязательный
Custom browser screen width
browser_screen_heightintegerНеобязательный
Custom browser screen height
browser_screen_resolution_rationumberНеобязательный
Screen resolution ratio for rectangle calculations

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

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

Ответ

Поля ответа

versionstringНеобязательный
The current version of the API
status_codeintegerНеобязательный
General status code
status_messagestringНеобязательный
General informational message
timestringНеобязательный
Execution time, seconds
costnumberНеобязательный
Total tasks cost, USD
tasks_countintegerНеобязательный
The number of tasks in the tasks array
tasks_errorintegerНеобязательный
The number of tasks in the tasks array returned with an error
tasksstring[]Необязательный
Array of tasks
resultstring[]Необязательный
Array of live SERP results
keywordstringНеобязательный
Keyword received in the POST array
typestringНеобязательный
Search engine type in the POST array
se_domainstringНеобязательный
Search engine domain in the POST array
location_codeintegerНеобязательный
Location code in the POST array
language_codestringНеобязательный
Language code in the POST array
check_urlstringНеобязательный
Search URL with refinement parameters
item_typesstring[]Необязательный
Types of search results found in SERP
items_countintegerНеобязательный
Number of results returned in the items array
itemsstring[]Необязательный
Elements of search results found in SERP