GOOGLE AD LIBRARY API
Ad Details
Retrieve ad details from Google Ad Library with a single API request.
GET
/api/data/v1/google/ad1credit base costZero-credit cache supported
Request parameters
Up to 1 creditThe url of the ad
If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). [See the Caching page for details.]
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR07541154843046445057%2Fcreative%2FCR17778900238552006657' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"advertiserId": "AR07541154843046445057",
"creativeId": "CR17778900238552006657",
"firstShown": "2026-06-05T21:52:15.000Z",
"url": "https://adstransparency.google.com/advertiser/AR07541154843046445057/creative/CR17778900238552006657",
"lastShown": "2026-06-24T19:04:54.000Z",
"format": "image",
"overallImpressions": {
"min": "500000",
"max": "600000"
},
"spend": {
"currency": "USD",
"lower": "5000",
"upper": "6000"
},
"targeting": {
"age": {
"included": [
"25-34"
],
"excluded": [
"18-24"
]
},
"gender": {
"included": [
"female"
],
"excluded": []
},
"location": {
"included": [
{
"criterionId": "2840",
"name": "United States",
"fullName": "United States",
"countryCodes": [
"US"
]
}
],
"excluded": [
{
"criterionId": "2578",
"name": "Norway",
"fullName": "Norway",
"countryCodes": [
"NO"
]
}
]
}
},
"creativeRegions": [
{
"regionCode": "US",
"regionName": "United States"
}
],
"regionStats": [
{
"regionCode": "US",
"regionName": "United States",
"firstShown": "2026-06-05T00:00:00.000Z",
"lastShown": "2026-06-24T00:00:00.000Z",
"impressions": {
"lower": "500000",
"upper": "600000"
},
"platformImpressions": []
}
],
"variations": [
{
"destinationUrl": "shop.gop.com",
"headline": "Classic GOP Quarter - Zip Pullover | Shop American ... Classic GOP Moisture Wicking Polo Shirt XL / Red Classic GOP Hat White / White Classic GOP Quarter - Zip Pullover | Shop American ... Official Party Quarter - Zip Pullover M / GOLD Classic GOP Hat Red / White",
"description": "FORE MORE Official Party Quarter - Zip Pullover XL / US FLAG Classic GOP Hat White / Red DJT Triple Threat Hat AMERICA America Swings Right T- Shirt XL / White Browse More",
"allText": "Official GOP Shop 寬 shop.gop.com Classic GOP Quarter - Zip Pullover | Shop American ... Classic GOP Moisture Wicking Polo Shirt XL / Red Fi Classic GOP Hat White / White Classic GOP Quarter - Zip Pullover | Shop American ... Official Party Quarter - Zip Pullover M / GOLD Classic GOP Hat Red / White D FORE MORE YEARS Official Party Quarter - Zip Pullover XL / US FLAG Classic GOP Hat White / Red DJT Triple Threat Hat AMERICA RIGHT America Swings Right T- Shirt XL / White Browse More",
"imageUrl": "https://tpc.googlesyndication.com/archive/simgad/18242167605449878359"
}
],
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Illustrative response with example values adapted for FetchGoblin. Run a request to retrieve current platform data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"advertiserId": {
"type": "string"
},
"creativeId": {
"type": "string"
},
"firstShown": {
"type": "string"
},
"url": {
"type": "string"
},
"lastShown": {
"type": "string"
},
"format": {
"type": "string"
},
"overallImpressions": {
"type": "object",
"properties": {
"min": {
"type": "string"
},
"max": {
"type": "string"
}
}
},
"spend": {
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"lower": {
"type": "string"
},
"upper": {
"type": "string"
}
}
},
"targeting": {
"type": "object",
"properties": {
"age": {
"type": "object",
"properties": {
"included": {
"type": "array",
"items": {
"type": "string"
}
},
"excluded": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"gender": {
"type": "object",
"properties": {
"included": {
"type": "array",
"items": {
"type": "string"
}
},
"excluded": {
"type": "array"
}
}
},
"location": {
"type": "object",
"properties": {
"included": {
"type": "array",
"items": {
"type": "object",
"properties": {
"criterionId": {
"type": "string"
},
"name": {
"type": "string"
},
"fullName": {
"type": "string"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"properties": {
"criterionId": {
"type": "string"
},
"name": {
"type": "string"
},
"fullName": {
"type": "string"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
}
},
"creativeRegions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"regionCode": {
"type": "string"
},
"regionName": {
"type": "string"
}
}
}
},
"regionStats": {
"type": "array",
"items": {
"type": "object",
"properties": {
"regionCode": {
"type": "string"
},
"regionName": {
"type": "string"
},
"firstShown": {
"type": "string"
},
"lastShown": {
"type": "string"
},
"impressions": {
"type": "object",
"properties": {
"lower": {
"type": "string"
},
"upper": {
"type": "string"
}
}
},
"platformImpressions": {
"type": "array"
}
}
}
},
"variations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"destinationUrl": {
"type": "string"
},
"headline": {
"type": "string"
},
"description": {
"type": "string"
},
"allText": {
"type": "string"
},
"imageUrl": {
"type": "string"
}
}
}
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}