DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live Google Organic SERP HTML
Returns the ranked results for a keyword 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[]
- depth類型: integer
Parsing depth, default 100, max 700
- device類型: string
Device type: desktop or mobile
- expand類型: boolean
_ai _overview Expand AI overview item
- keyword類型: string
Keyword to search for.
- language類型: string
_code Search engine language code
- language類型: string
_name Full name of search engine language
- load類型: boolean
_async _ai _overview Load asynchronous AI overview
- location類型: integer
_code Search engine location code
- location類型: string
_coordinate GPS coordinates of a location
- location類型: string
_name Full name of search engine location
- max類型: integer
_crawl _pages Page crawl limit, max 100
- os類型: string
Device operating system
- se類型: string
_domain Custom search engine domain
- search類型: string
_param Additional parameters of the search query
- tag類型: string
User-defined task identifier
- url類型: string
Direct URL of the search query
- 類型: object200
Successful response
- 類型: numbercost
Request cost in USD
- 類型: integerstatus
_code General status code
- 類型: stringstatus
_message General informational message
- 類型: stringtasks
Array of live task objects
- 類型: integertasks
_count Number of tasks returned
- 類型: integertasks
_error Number of tasks returned with an error
- 類型: stringtasks[]
.id Task identifier
- 類型: stringtasks[]
.result Result array containing HTML pages
- 類型: stringtasks[]
.result[] .items HTML page items
- 類型: stringtasks[]
.result[] .items[] .html Raw HTML page content
- 類型: stringtime
Execution time
- 類型: stringversion
API version
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/organic/live/html \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url": "",
"location_name": "",
"location_code": 1,
"location_coordinate": "",
"language_name": "",
"language_code": "",
"device": "",
"os": "",
"se_domain": "",
"depth": 1,
"max_crawl_pages": 1,
"search_param": "",
"load_async_ai_overview": true,
"expand_ai_overview": true,
"tag": "",
"keyword": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": "string",
"tasks[].id": "string",
"tasks[].result": "string",
"tasks[].result[].items": "string",
"tasks[].result[].items[].html": "string"
}