DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live Google Ai Mode SERP HTML
Returns Google's AI Mode answer for a query, with the sources it cites on Google, synchronously. Raw page source rather than parsed results. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.
- Тип: array object[]
- keywordТип: stringобязательно
Keyword; you can specify up to 700 characters
- deviceТип: string
Device type: desktop or mobile
- languageТип: string
_code Search engine language code; required if language_name is not specified
- languageТип: string
_name Full name of search engine language; required if language_code is not specified
- locationТип: integer
_code Search engine location code; required if location_name or location_coordinate is not specified
- locationТип: string
_coordinate GPS coordinates of a location; required if location_name or location_code is not specified
- locationТип: string
_name Full name of search engine location; required if location_code or location_coordinate is not specified
- Тип: object200
Successful response
- Тип: numbercost
Total tasks cost, USD
- Тип: integerstatus
_code General status code
- Тип: stringstatus
_message General informational message
- Тип: array string[]tasks
Array of tasks
- Тип: integertasks
_count The number of tasks in the tasks array
- Тип: integertasks
_error The number of tasks in the tasks array returned with an error
- Тип: numbertasks[]
.cost Cost of the task, USD
- Тип: objecttasks[]
.data Contains the same parameters specified in the POST request
- Тип: stringtasks[]
.id Task identifier
- Тип: array string[]tasks[]
.path URL path
- Тип: array string[]tasks[]
.result Array of HTML results
- Тип: integertasks[]
.result _count Number of elements in the result array
- Тип: stringtasks[]
.result[] .keyword Keyword received in the POST array
- Тип: stringtasks[]
.result[] .language _code Language code in the POST array
- Тип: integertasks[]
.result[] .location _code Location code in the POST array
- Тип: stringtasks[]
.result[] .se _domain Search engine domain in the POST array
- Тип: stringtasks[]
.result[] .type Search engine type in the POST array
- Тип: integertasks[]
.status _code Task status code
- Тип: stringtasks[]
.status _message Task status message
- Тип: stringtasks[]
.time Execution time, seconds
- Тип: stringtime
Execution time, seconds
- Тип: 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/live/html \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_name": "",
"location_code": 1,
"location_coordinate": "",
"language_name": "",
"language_code": "",
"device": ""
}
]'
{
"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[].se_domain": "string",
"tasks[].result[].location_code": 1,
"tasks[].result[].language_code": "string"
}