資料 API / DataForSEO / SERP

Setting Google Ads Advertisers SERP Tasks

Queues the advertisers matching a query in Google's ads transparency data 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 advertisers for
location_namestring選填
Full name of search engine location
location_codeinteger選填
Search engine location code
priorityinteger選填
Task priority
postback_urlstring選填
URL for sending task results
pingback_urlstring選填
Notification URL of a completed task
postback_datastring選填
Postback datatype; only advanced is supported

請求範例

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_advertisers/task_post" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "priority": 0,
  "postback_url": "<string>",
  "pingback_url": "<string>",
  "postback_data": "<string>"
}'

回應

回應欄位

versionstring選填
The current version of the API
status_codeinteger選填
General status code
status_messagestring選填
General informational message
timestring選填
Execution time, seconds
costnumber選填
Total tasks cost, USD
tasks_countinteger選填
The number of tasks in the tasks array
tasks_errorinteger選填
The number of tasks in the tasks array 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選填
Cost of the task, USD
result_countinteger選填
Number of elements in the result array