Google Ad Library

Company Ads

Fetches public ads for a company from the Google Ad Transparency Library by domain or advertiser_id. Each ad includes advertiserId, creativeId, format, adUrl, advertiserName, domain, firstShown, and lastShown. Costs 25 credits per request when get_ad_details=true; without it, only advertiserId and creativeId are returned at 1 credit.

get/v1/google/company/ads

Query parameters

domainstring

The domain of the company

advertiser_idstring

The advertiser id of the company

topic'all' | 'political'

The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU'

regionstring

The region to search for. Defaults to anywhere

start_datestring

Start date to search for. Format: YYYY-MM-DD

end_datestring

End date to search for. Format: YYYY-MM-DD

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

Platform to search for.

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

Ad format to search for.

get_ad_detailsstring

Set to true to get the ad details. Will cost 25 credits.

cursorstring

Cursor to paginate through results

Response

Successful response

Changes

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