Get Google AI Mode SERP Advanced Results by id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Get Google AI Mode SERP Advanced Results by id
Retrieves a queued Google ai mode result by id. 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.
- Type: stringidrequired
Task identifier in UUID format
- Type: object200
Successful response
- Type: numbercost
Total tasks cost, USD
- Type: integerstatus
_code General status code
- Type: stringstatus
_message General informational message
- Type: array string[]tasks
Array of tasks
- Type: integertasks
_count The number of tasks in the tasks array
- Type: integertasks
_error The number of tasks in the tasks array returned with an error
- Type: numbertasks[]
.cost Cost of the task, USD
- Type: objecttasks[]
.data Contains the same parameters specified in the POST request
- Type: stringtasks[]
.id Task identifier
- Type: array string[]tasks[]
.path URL path
- Type: array string[]tasks[]
.result Array of SERP results
- Type: integertasks[]
.result _count Number of elements in the result array
- Type: stringtasks[]
.result[] .check _url Search URL with refinement parameters
- Type: array string[]tasks[]
.result[] .item _types Types of search results found in SERP
- Type: array string[]tasks[]
.result[] .items Elements of search results found in SERP
- Type: integertasks[]
.result[] .items _count Number of results returned in the items array
- Type: stringtasks[]
.result[] .items[] .markdown Content of the element in markdown format
- Type: stringtasks[]
.result[] .items[] .type Type of element, such as ai_overview
- Type: stringtasks[]
.result[] .keyword Keyword received in the POST array
- Type: integertasks[]
.result[] .se _results _count Total number of results in SERP
- Type: stringtasks[]
.result[] .type Search engine type in the POST array
- Type: integertasks[]
.status _code Task status code
- Type: stringtasks[]
.status _message Task status message
- Type: stringtasks[]
.time Execution time, seconds
- Type: stringtime
Execution time, seconds
- Type: stringversion
The current version of the API
application/json - 400
Bad request
- 401
Unauthorized
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
Rate limit exceeded
- 500
Internal server error
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/task_get/advanced/{id}' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].time": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1,
"tasks[].path": [
"string"
],
"tasks[].data": {},
"tasks[].result": [
"string"
],
"tasks[].result[].keyword": "string",
"tasks[].result[].type": "string",
"tasks[].result[].check_url": "string",
"tasks[].result[].item_types": [
"string"
],
"tasks[].result[].se_results_count": 1,
"tasks[].result[].items_count": 1,
"tasks[].result[].items": [
"string"
],
"tasks[].result[].items[].type": "string",
"tasks[].result[].items[].markdown": "string"
}