Built-in tool
Get Google Ad Library Ad Details
Retrieves detailed information about a specific Google ad including advertiserId, creativeId, format, firstShown, lastShown, and overallImpressions. When Google publishes political-ad transparency data, spend contains the currency and amount bounds, while targeting contains included and excluded age, gender, and location criteria. Targeted locations include their Google criterion ID, display name, full name, and country codes. Optional fields are null when Google does not publish them. regionStats and platformImpressions use lower and upper impression bounds. Variations are best-effort, omit unparseable entries, and have creative-type-dependent fields; image creatives can expose an images array. Text extraction uses OCR, so accuracy may vary.
1 creditNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| urlstring · required | string | required | The url of the ad |
| cache_max_agestring · optional | string | optional | See the Caching page for details. One of: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"spend": {
"type": "object",
"additionalProperties": {}
},
"format": {
"type": "string"
},
"lastShown": {
"type": "string"
},
"targeting": {
"type": "object",
"additionalProperties": {}
},
"creativeId": {
"type": "string"
},
"firstShown": {},
"variations": {
"type": "array"
},
"regionStats": {
"type": "array"
},
"advertiserId": {
"type": "string"
},
"creativeRegions": {
"type": "array"
},
"overallImpressions": {
"type": "object",
"additionalProperties": {}
}
},
"additionalProperties": true
}
