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.
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
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.