> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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]. Queues the advertisers matching a query in Google's ads transparency data on Google, returning a task `id` in `tasks[0].id`. The charge lands here; fetching is free, including re-fetching. 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 ```bash theme={null} curl -X POST "https://api.aisa.one/apis/v1/dataforseo/serp/google/ads_advertisers/task_post" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '[{"keyword": "...", "location_name": "...", "location_code": "..."}]' ``` ## OpenAPI ````yaml openapi/dataforseo.json POST /dataforseo/serp/google/ads_advertisers/task_post openapi: 3.0.3 info: title: DataForSEO API version: 1.0.0 description: DataForSEO API endpoints exposed through the AIsa unified gateway. servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /dataforseo/serp/google/ads_advertisers/task_post: post: summary: Setting Google Ads Advertisers SERP Tasks description: >- Google Ads Advertisers provides information on advertisers that run campaigns on Google Ads based on the Ads Transparency platform. operationId: post_dataforseo_serp_gads_advertisers_submit requestBody: required: true content: application/json: schema: type: array items: type: object properties: keyword: type: string description: >- keyword required field you can specify up to 700 characters in the keyword field all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your keyword, please specify it as “%25”; if you need to use the “+” character for your keyword, please specify it as “%2B” learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article location_name: type: string description: >- full name of search engine location optional field if you use this field, you don't need to specify location_code or location_coordinate you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations example: London,England,United Kingdom Note: if you don't specify location_name, location_code, or location_coordinate, advertisers will be searched across all the available locations location_code: type: integer description: >- search engine location code optional field if you use this field, you don't need to specify location_name or location_coordinate you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/google/ads_advertisers/locations example: 2840 Note: if you don't specify location_name, location_code, or location_coordinate, advertisers will be searched across all the available locations priority: type: integer description: >- task priority optional field can take the following values: 1 – normal execution priority (set by default) 2 – high execution priority You will be additionally charged for the tasks with high execution priority. postback_url: type: string description: >- URL for sending task results optional field once the task is completed, we will send a POST request with its results compressed in the gzip format to the postback_url you specified you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request. example: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Note: special characters in postback_url will be urlencoded; i.a., the # character will be encoded into %23 learn more on our Help Center pingback_url: type: string description: >- notification URL of a completed task optional field when a task is completed we will notify you by GET request sent to the URL you have specified you can use the ‘$id’ string as a $id variable and ‘$tag’ as urlencoded $tag variable. We will set the necessary values before sending the request. example: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Note: special characters in pingback_url will be urlencoded; i.a., the # character will be encoded into %23 learn more on our Help Center postback_data: type: string description: >- postback_url datatype required field if you specify postback_url corresponds to the function you used for setting a task possible values: advanced required: - keyword responses: '200': description: Successful operation content: application/json: schema: type: object properties: version: type: string description: The current version of the API status_code: type: integer description: >- general status code you can find the full list of the response codes here status_message: type: string description: >- general informational message you can find the full list of general informational messages here time: type: string description: total execution time, seconds cost: type: number description: Total tasks cost, USD tasks_count: type: integer description: The number of tasks in the tasks array tasks_error: type: integer description: >- The number of tasks in the tasks array returned with an error tasks: type: array items: type: string description: array of tasks tasks[].id: type: string description: >- task identifier unique task identifier in our system in the UUID format tasks[].status_code: type: integer description: >- status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here tasks[].status_message: type: string description: >- informational message of the task you can find the full list of general informational messages here tasks[].cost: type: number description: total tasks cost, USD tasks[].result_count: type: integer description: Number of elements in the result array '400': description: Bad request '401': description: Unauthorized '429': description: Rate limit exceeded '500': description: Internal server error components: securitySchemes: BearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.