List Google company ads
List ads a company or advertiser is running in Google Ad Transparency.
Headers
Get your API keyAPI key (`sfk_...`)
Company domain when you do not have an advertiser id.
min 1 chars · max 4096 chars
Google Ad Transparency advertiser id when you have it instead of a domain.
min 1 chars · max 4096 chars
Optional topic filter. When `political`, `region` is required.
one of: all, political
Optional region filter as a two-letter country code.
Optional start date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Optional end date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Optional Google surface filter.
one of: google_maps, google_play, google_search, google_shopping, youtube
Optional creative format filter.
one of: text, image, video
Opaque pagination cursor from a previous response.
min 1 chars
Endpoint-specific response payload.
Whether the company or advertiser resolved for this request.
one of: found, not_found
Ads returned for the requested company or advertiser. This array may be empty when the lookup resolves but no ads match the filters.
Google Ad Transparency advertiser id.
min 1 chars
Google Ad Transparency creative id.
min 1 chars
Creative format when available (text, image, or video).
Public Google Ad Transparency URL for this creative when available.
Advertiser display name when available.
Advertiser domain when available.
Preview image URL when available.
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; null when neither bound is reported.
Lower bound for impressions when available.
≥ 0
Upper bound for impressions when available.
≥ 0
Regions where the creative ran, one entry per region. `regionCode` is an upper-case two-letter code, or null when no valid code is reported. Empty when not reported.
Two-letter region code when available.
Human-readable region name when available.
Creative variations for this ad: headline, description, landing page and media. Destination URLs reported without a scheme are returned with `https://`. Empty when not reported.
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.
Display URL shown on the ad (often a bare domain) when available.
YouTube URL for video creatives when available.
Estimated total number of matching ads when reported; otherwise null.
≥ 0
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of ads can be requested.
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/companies/ads?domain=lululemon.com" \
-H "x-api-key: YOUR_API_KEY"Responses
Ads for the requested company or advertiser.