資料 API / DataForSEO / SERP
Setting Google Organic SERP Tasks
Queues the ranked results for a keyword on Google, returning a task id in tasks[0].id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.
參數
沒有路徑、查詢或請求標頭參數。
請求主體
keywordstring必填Keyword to search for
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
depthinteger選填Parsing depth, default 100, max 700
max_crawl_pagesinteger選填Page crawl limit, max 100
devicestring選填Device type: desktop or mobile
osstring選填Device operating system
group_organic_resultsboolean選填Display related results as grouped organic results
calculate_rectanglesboolean選填Calculate pixel rankings for SERP elements in advanced results
postback_urlstring選填Postback URL for completed task results
pingback_urlstring選填Pingback URL for task completion notification
postback_datastring選填Postback payload type
tagstring選填User-defined task identifier
請求範例
curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/task_post" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "<string>",
"location_name": "<string>",
"location_code": 0,
"location_coordinate": "<string>",
"language_name": "<string>",
"language_code": "<string>",
"depth": 0,
"max_crawl_pages": 0
}'回應
回應欄位
versionstring選填API version
status_codeinteger選填General status code
status_messagestring選填General informational message
timestring選填Execution time
costnumber選填Total tasks cost in USD
tasks_countinteger選填Number of tasks in the request
tasks_errorinteger選填Number of tasks returned with an error
tasksstring選填Array of task objects
idstring選填Task identifier in UUID format
status_codeinteger選填Task status code
status_messagestring選填Task status message
costnumber選填Task cost
result_countinteger選填Number of result elements