Sign in
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