Skip to content

DataForSEO · Google Ads Transparency

Ads run by an advertiser

Google Ads Transparency: ads run by an advertiser (live), by DataForSEO. Creatives, formats, first and last shown dates from the Google Ads Transparency Center. Price: $0.002 per SERP page of 40 ads. Billed at the cost DataForSEO reports for the call; the quote is the upper bound.

Usage based DataForSEOSEOdataforseo/google-ads-searchActive

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool dataforseo/google-ads-search (Google Ads Transparency: ads run by an advertiser (live)). Call inspect_tool with {"tool_id": "dataforseo/google-ads-search"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "dataforseo/google-ads-search" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
targetstringNoAdvertiser domain (one of target or advertiser_ids).
advertiser_idsstring[]NoAdvertiser ids from dataforseo/google-ads-advertisers.
location_codeintegerNoLocation code from DataForSEO (location_code (2840 United States, 2250 France, 2826 United Kingdom, 2276 Germany, 2724 Spain, 2380 Italy, 2124 Canada) or location_name such as "Paris,Ile-de-France,France").
location_namestringNoFull location name, e.g. "London,England,United Kingdom" or "France".
platformstringNoOptions: all, google_play, google_maps, google_search, google_shopping, youtube.
formatstringNoOptions: all, text, image, video.
date_fromstringNoFrom 2018-05-31.
date_tostringNo
depthintegerNoAds, billed per 40.

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "dataforseo/google-ads-search",
  "input": {
    "target": "nike.com",
    "location_code": 2840,
    "depth": 10
  }
}

Price and billing

Price
Usage based
Model
Usage based
Detail
Billed at the cost the provider reports for the call, never above $0.1. Your agent sees the maximum before running.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.