数据 API / DataForSEO / SERP
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.
参数
没有路径、查询或请求头参数。
请求体
urlstring可选Direct URL of the search query
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
se_domainstring可选Custom search engine domain
depthinteger可选Parsing depth, default 100, max 700
max_crawl_pagesinteger可选Page crawl limit, max 100
search_paramstring可选Additional parameters of the search query
load_async_ai_overviewboolean可选Load asynchronous AI overview
expand_ai_overviewboolean可选Expand AI overview item
tagstring可选User-defined task identifier
keywordstring可选Keyword to search for.
请求示例
curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "<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可选Result array containing HTML pages
itemsstring可选HTML page items
htmlstring可选Raw HTML page content