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 in tasks[0].id. The charge lands here; fetching is free, including re-fetching. 💰 Measured at 0.012 billed - this family is the cheapest source of search data here, six times under the flat rate. 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.
Example
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Keyword to search advertisers for
Full name of search engine location
Search engine location code
Task priority
URL for sending task results
Notification URL of a completed task
Postback datatype; only advanced is supported
Response
Successful response
The current version of the API
General status code
General informational message
Execution time, seconds
Total tasks cost, USD
The number of tasks in the tasks array
The number of tasks in the tasks array returned with an error
Array of task objects
Task identifier in UUID format
Task status code
Task status message
Cost of the task, USD
Number of elements in the result array