資料 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