googleAdLibrary

Company Ads

Get public ads for a company from the Google Ad Transparency Library. Only publicly accessible ads are returned — login-gated ads cannot be retrieved. Ad text is extracted via OCR, so response times may be slightly longer.

get/v1/scrape/google-ad-library/company-ads

Request

  • Base URL: https://api.sociavault.com
  • URL: https://api.sociavault.com/v1/scrape/google-ad-library/company-ads
  • Auth: API key in header X-API-Key

Query parameters

domainstring
Example:lululemon.com

The domain of the company

advertiser_idstring
Example:AR01614014350098432001

The advertiser id of the company

topic'all' | 'political'
Example:all

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

regionstring
Example:US

The region to search for. Defaults to anywhere

start_datestring
Example:2025-08-01

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

end_datestring
Example:2025-08-11

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

cursorstring
Example:CgoAP7znOo9RPjf%2FEhD5utgx8m75NrTTbU0AAAAAGgn8%2BJyW%2BJQK40A%3D

Cursor to paginate through results

Response

Successful response

Changes

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