Get Google Ad Library ad
Get a single Google Ad Transparency creative by public Ad Transparency URL.
Headers
Get your API keyAPI key (`sfk_...`)
Public Google Ad Transparency URL for the creative.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the ad was found in the Ad Transparency Library.
one of: found, not_found
Ad details when found; otherwise null.
Google Ad Transparency advertiser id.
min 1 chars
Google Ad Transparency creative id.
min 1 chars
Creative format when available (text, image, or video).
ISO-8601 timestamp for when the ad was first shown, when available.
ISO-8601 timestamp for when the ad was last shown, when available.
Overall impression range when available.
Lower bound for impressions when available.
≥ 0
Upper bound for impressions when available.
≥ 0
Regions where the creative ran.
Two-letter region code when available.
Human-readable region name when available.
Per-region impression and date stats.
Two-letter region code when available.
Human-readable region name when available.
ISO-8601 timestamp for when the ad was first shown in this region, when available.
ISO-8601 timestamp for when the ad was last shown in this region, when available.
Impression range for this region when available.
Lower bound for impressions when available.
≥ 0
Upper bound for impressions when available.
≥ 0
Per-platform impression breakdowns when available.
Platform label when available.
Impression range for this platform when available.
Lower bound for impressions when available.
≥ 0
Upper bound for impressions when available.
≥ 0
Creative variations for this ad.
Landing page or destination URL when available.
Ad headline when available. Text may be OCR-extracted and imperfect.
Ad description when available. Text may be OCR-extracted and imperfect.
Combined visible text when available. Text may be OCR-extracted and imperfect.
Creative image URL when available. Falls back to the first entry in `images` when no dedicated image URL is reported.
All image URLs reported for this variation, such as Shopping product images. Empty when none are reported.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/google/ad-library/ads?url=https://www.example.com/social/content/example123" \
-H "x-api-key: YOUR_API_KEY"Responses
Ad Library ad detail.