Google

List Google company ads

List ads a company or advertiser is running in Google Ad Transparency.

get/v1/google/ad-library/companies/ads

Request

  • Base URL: https://api.socialfetch.dev
  • URL: https://api.socialfetch.dev/v1/google/ad-library/companies/ads
  • Auth: one of:
    • API key in header x-api-key
    • none

Query parameters

domainstring

Company domain when you do not have an advertiser id.

advertiserIdstring

Google Ad Transparency advertiser id when you have it instead of a domain.

topic'all' | 'political'

Optional topic filter. When political, region is required.

regionstring

Optional region filter as a two-letter country code.

startDatestring

Optional start date filter in YYYY-MM-DD format.

endDatestring

Optional end date filter in YYYY-MM-DD format.

platform'google_maps' | 'google_play' | 'google_search' | 'google_shopping' | 'youtube'

Optional Google surface filter.

format'text' | 'image' | 'video'

Optional creative format filter.

cursorstring

Opaque pagination cursor from a previous response.

Response

Ads for the requested company or advertiser.

Changes

No recorded changes to this operation across all 1 revision of this API.