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
Public Google Ad Transparency URL for this creative.
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
Audience targeting when reported; otherwise null.
Age ranges, such as `25-34`, targeting.
Age ranges, such as `25-34`, the advertiser targeted. Empty when none.
Age ranges, such as `25-34`, the advertiser excluded. Empty when none.
Genders targeting.
Genders the advertiser targeted. Empty when none.
Genders the advertiser excluded. Empty when none.
Location targeting.
Locations the advertiser targeted. Empty when none.
Google Ads geo target criterion id when available.
Location name when available.
Full location name, including parent regions, when available.
Two-letter country codes this location covers. Empty when none are reported.
Locations the advertiser excluded. Empty when none.
Google Ads geo target criterion id when available.
Location name when available.
Full location name, including parent regions, when available.
Two-letter country codes this location covers. Empty when none are reported.
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
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.