ConvertFleet

MCP docs › Tools › Google Ads Transparency Search

Google Ads Transparency Search

google_ads_transparency fast Ad intelligence

Check whether a business or brand is running GOOGLE ads right now. Reads Google's public Ads Transparency Center and returns each matching advertiser with its verified name, advertiser ID, region and live ad count. No match is a REAL answer meaning nobody advertises under that name in that region — not a failure. Keyless and fast (about a second).

When to use. Answering 'is this business running Google ads?' for one named advertiser, in about a second. Keyless.
Not for. Facebook/Instagram ads (use facebook_ads_scrape) or scanning a whole niche (use ad_library_lead_finder).

Parameters

NameTypeRequiredDefaultDescription
query string yes — Advertiser, business or brand name to look up, e.g. "Joe's 2 Sons Plumbing".
country string no "US" ISO country code of the market to check, e.g. 'US', 'GB', 'DE'. Advertisers are verified per region.
limit integer no 20 Max advertisers to return (1-50).

Returns

One row per matching verified advertiser. Zero matches is a real answer: nobody advertises under that name in that region.

Each row typically carries: advertiser_name advertiser_id region ad_count transparency_url verified

The response body is { status, count, fields, results }. Runs that exceed the inline wait return { status: "running", job_id, tool_flow } instead — see Jobs & errors.

Call it over MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_transparency",
    "arguments": {
      "query": "Joe's 2 Sons Plumbing",
      "country": "US",
      "limit": 20
    }
  }
}

Call it over the REST API

curl -X POST https://convertfleet.online/api/tool-run \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"gads","params":{"query":"Joe's 2 Sons Plumbing","country":"US","max_results":20}}'

Both paths run the same job engine, enforce the same plan limits and count against the same monthly quota. See the REST API page.

Related tools

facebook_ads_scrapeSeeing the actual creative a brand is running on Facebook/Instagram right now — ad copy, CTA, media type, start date. Competitor ad researchad_library_lead_finderProspecting for an agency: find businesses in a niche+city, check BOTH Google and Meta ad libraries, and get a scored, ranked lead list with

JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Advertiser, business or brand name to look up, e.g. \"Joe's 2 Sons Plumbing\"."
    },
    "country": {
      "type": "string",
      "description": "ISO country code of the market to check, e.g. 'US', 'GB', 'DE'. Advertisers are verified per region.",
      "default": "US"
    },
    "limit": {
      "type": "integer",
      "description": "Max advertisers to return (1-50).",
      "default": 20
    }
  },
  "additionalProperties": false,
  "required": [
    "query"
  ]
}