Built-in tool
Get Google Ad Library Company Ads
Fetches public ads for a company from the Google Ad Transparency Library by domain or advertiser_id. Each ad includes advertiserId, creativeId, format, adUrl, advertiserName, domain, firstShown, and lastShown.
5 creditsNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| limitnumber · optional | number | optional | Maximum number of results to return from this request. Leave empty for everything this request returns. This trims the response — it does not fetch more; use the returned cursor for the next batch. The price is the same either way. |
| topicstring · optional | string | optional | The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU' One of: |
| cursorstring · optional | string | optional | Cursor to paginate through results |
| domainstring · optional | string | optional | The domain of the company |
| formatstring · optional | string | optional | Ad format to search for. One of: |
| regionstring · optional | string | optional | The region to search for. Defaults to anywhere |
| end_datestring · optional | string | optional | End date to search for. Format: YYYY-MM-DD |
| platformstring · optional | string | optional | Platform to search for. One of: |
| start_datestring · optional | string | optional | Start date to search for. Format: YYYY-MM-DD |
| advertiser_idstring · optional | string | optional | The advertiser id of the company |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ads": {
"type": "array"
},
"cursor": {
"type": "string"
},
"limitApplied": {
"type": "boolean",
"description": "True when a Limit trimmed the results; there were more in this response."
},
"number_of_ads_estimate": {
"type": "number"
}
},
"additionalProperties": true
}
