List Google company ads
List ads a company or advertiser is running in Google Ad Transparency.
Google Ad Transparency only includes public ads.
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 (`data.page.nextCursor`).
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.
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
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.