SCscrapecreators
Google Ad Library

Company Ads

Changed on

Fetches public company ads by domain or advertiser_id. The default list includes IDs, previews, and firstShown/lastShown when available, at 1 credit per request. firstShown can be null in /v1/google/ad for the same ad, so keep the list date rather than overwriting it with a null detail date. Setting get_ad_details=true uses the individual-ad source, which can also omit firstShown, and costs 25 credits per request. Login-only ads are unavailable.

get/v1/google/company/ads

Request

  • Base URL
    https://api.scrapecreators.com
  • URL
    https://api.scrapecreators.com/v1/google/company/ads
  • Auth
    API key in header x-api-key

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

  • 194a51c4f2d9Revision changes
    • info

      added the new optional query request parameter format

    • info

      added the new optional query request parameter platform