google_company_ads
Retrieve public company ads from Google Ad Library by advertiser ID or domain, including run dates and optional ad details for competitive research.
Instructions
googleAdLibrary: Company Ads. GET /v1/google/company/ads. Provide one of: advertiser_id, domain. Get public company ads with dates when available (1 credit). Set get_ad_details=true for full details (25 credits). firstShown can be null in detail responses even when the default list has it. Costs 1 credit when it succeeds. Costs 25 credits when get_ad_details is set. Costs 0 credits when ads is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "google_company_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | No | Topic to search for. Political searches also require region, such as US or AU. | |
| cursor | No | Cursor to paginate through results | |
| domain | No | The domain of the company | |
| format | No | Ad format to search for. | |
| region | No | The region to search for. Defaults to anywhere | |
| end_date | No | End date to search for. Format: YYYY-MM-DD | |
| platform | No | Platform to search for. | |
| start_date | No | Start date to search for. Format: YYYY-MM-DD | |
| advertiser_id | No | The advertiser id of the company | |
| get_ad_details | No | Set true to include ad details for 25 credits per request; otherwise IDs only for 1 credit. |