dataforseo_x_serp-google-ads-search-task-post $0.001 per call

Google Ads Transparency ads by advertiser (async task). Google Ads Search provides information on ads that are run by advertisers on Google Ads. (DataForSEO · Google Keyword Data) Async task: answers 202 with a job id; poll GET /v1/jobs/<id>. Price depends on the options (up to $0.001); refunded if the task fails. Prepaid credits only.

POST https://toll402.dev/v1/p/dataforseo.x.serp-google-ads-search-task-post
{
 "location_code": 2840,
 "platform": "google_search",
 "advertiser_ids": [
  "AR13752565271262920705",
  "AR02439908557932462081"
 ]
}

Input schema

{
 "type": "object",
 "properties": {
  "advertiser_ids": {
   "type": "array",
   "description": "advertiser identifiers required field if target is not specified you can specify the maximum of 25 values in this array; advertiser_ids values for this parameter can be found in the <a href=\"http://docs.dataforseo.com/v3/serp/googl",
   "examples": [
    [
     "AR13752565271262920705",
     "AR02439908557932462081"
    ]
   ]
  },
  "target": {
   "type": "string",
   "description": "domain name required field if advertiser_ids is not specified domain name associated with an advertiser account"
  },
  "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",
   "examples": [
    2840
   ]
  },
  "depth": {
   "type": "integer",
   "description": "parsing depth optional field number of results in SERP default value: 40 max value: 700 Your account will be billed per each SERP containing up to 40 results; Setting depth above 40 may result in additional charges <a href=\"http"
  },
  "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. The cost can be calculated o"
  },
  "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"
  },
  "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’ a"
  },
  "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"
  },
  "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</c"
  },
  "location_coordinate": {
   "type": "string",
   "description": "GPS coordinates of a location optional field if you use this field, you don't need to specify location_name or location_code example: 52.6178549,-155.352142 Note: if you don't s"
  },
  "tag": {
   "type": "string",
   "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response"
  },
  "platform": {
   "type": "string",
   "description": "advertising platform optional field possible values: all , google_play , google_maps , google_search , google_shopping , youtube default value: all",
   "examples": [
    "google_search"
   ]
  },
  "format": {
   "type": "string",
   "description": "ad format optional field possible values: all , text , image , video"
  },
  "date_from": {
   "type": "string",
   "description": "starting date of the time range optional field required field if date_to is specified; date format: \"yyyy-mm-dd\" minimum value: 2018-05-31 maximum value: today's date example: \"2020-01-01\""
  },
  "date_to": {
   "type": "string",
   "description": "ending date of the time range optional field required field if date_from is specified; date format: \"yyyy-mm-dd\" minimum value: 2018-05-31 maximum value: today's date example: \"2020-01-01\""
  }
 },
 "additionalProperties": true,
 "description": "the POST body is a JSON array of up to 100 task objects with these fields, one per task; read each task's result (tasks[].id) with dataforseo.x.serp-google-ads-search-task-get-advanced, which only the submitting team can read"
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI