Google Advertiser Ad Search

Browse the ads an advertiser ran using Google's Ads Transparency Center to examine its advertising content.

  • 12 settings
  • REST API + MCP
  • Billed per run
  • Checked

What the tool takes12 settings · 1 required

Advertiser IDsDepthFormatTargetDate toPlatformDate fromLanguage codeLanguage nameLocation codeLocation nameLocation coordinate
Source: Settings come from the tool's live input schema, checked on 17 Nov 2026. Your assistant fills them from your request.

Settings Google Advertiser Ad Search takes

You describe the task in plain words and your AI assistant fills these in. In code you pass them yourself.

SettingWhat it controlsTip
Advertiser IDsAdvertiser ids from google-ads-advertisers (1-20).Required
DepthResults to collect (1-700, default 40); billed per page of 40.Optional · 1 to 700
FormatAd format (values: all, text, image, video)Optional
TargetDomain nameOptional
Date toEnding date of the time rangeOptional
PlatformAdvertising platform (default all; values: all, google_play, google_maps, google_search, google_shopping, youtube)Optional
Date fromStarting date of the time rangeOptional
Language codeLanguage code, e.g. 'en'. Give language_name or language_code.Optional · up to 10 characters
Language nameFull language name, e.g. 'English'. Give language_name or language_code.Optional · up to 60 characters
Location codeNumeric location code from the locations dictionary, e.g. 2840 (United States). Give one of location_name, location_code, or location_coordinate.Optional
Location nameFull location name exactly as listed in the locations dictionary, e.g. 'London,England,United Kingdom' or 'United States'. Give one of location_name, location_code, or location_coordinate.Optional · up to 200 characters
Location coordinate'latitude,longitude,radius' with the radius in metres (200-19999), e.g. '52.6178549,-155.352142,1000'. Alternative to location_name / location_code.Optional · up to 60 characters

How to use Google Advertiser Ad Search with your AI assistant

  1. Connect AI/ML API

    Click Try it now, pick your client and add the MCP server. You sign in with your AI/ML API account once.

  2. Describe the task

    Say what you need in one sentence, including the advertiser ids.

  3. Get the result

    Your assistant runs Google Advertiser Ad Search and shows what came back.

  4. Keep going in the chat

    Ask it to filter, compare or summarize the result, or to save it as a table.

Ways to use it

  • For a search-research brief: browse the ads an advertiser ran using Google's Ads Transparency Center to examine its advertising content.

Google Advertiser Ad Search in your code

In your AI assistant

MCP · sign in once with your AI/ML API account

MCP setup guide ↗

In your code

Backend, script or scheduled job

REST · your AI/ML API key, JSON records back

The same tool runs over REST with your AI/ML API key, so a backend, a script or a scheduled job can call Google Advertiser Ad Search directly. Start with the Toolbox REST quickstart.

Pricing

Pay as you goBilled per run from your AI/ML API balance

  • No subscription
  • No seat fee
  • One balance for every tool

Each run is billed from your AI/ML API balance, with no subscription or seat fee. Check the current price in your dashboard before large runs.

See pricing

FAQ

Do I need a separate account for Google Advertiser Ad Search?

No. It runs on your AI/ML API account and balance, from your AI assistant over MCP or from your code over REST.

Which AI assistants can use it?

Claude, ChatGPT, Cursor, Hermes, OpenClaw and other MCP clients. Add the AI/ML API MCP server once with the MCP quickstart.

Run Google Advertiser Ad Search from your assistant

Connect once, then ask for it in plain words.