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

Company Ads

cURL

curl --request GET \
  --url https://api.sociavault.com/v1/scrape/google-ad-library/company-ads \
  --header 'X-API-Key: <api-key>'

200

{
  "success": true,
  "data": {
    "success": true,
    "ads": {
      "0": {
        "advertiserId": "AR01614014350098432001",
        "creativeId": "CR16304891583101140993",
        "format": "image",
        "adUrl": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR16304891583101140993",
        "advertiserName": "lululemon athletica canada inc.",
        "domain": "lululemon.com",
        "imageUrl": null,
        "firstShown": "2026-01-13T21:55:14.000Z",
        "lastShown": "2026-02-08T23:43:47.000Z"
      }
    },
    "cursor": "CgoAP7zm1p%2BmCBpjEhBHJahAmRTF8HhdvzwAAAAAGgn8%2BH7I%2BNOQAlw%3D"
  },
  "creditsUsed": 1
}

💳 1 credit per request

Authorizations

X-API-Key · string · header · required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

domain · string

The domain of the company

Example:

"lululemon.com"

advertiser_id · string

The advertiser id of the company

Example:

"AR01614014350098432001"

topic · enum<string>

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

Available options: all, political

Example:

"all"

region · string

The region to search for. Defaults to anywhere

Example:

"US"

start_date · string

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

Example:

"2025-08-01"

end_date · string

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

Example:

"2025-08-11"

cursor · string

Cursor to paginate through results

Example:

"CgoAP7znOo9RPjf%2FEhD5utgx8m75NrTTbU0AAAAAGgn8%2BJyW%2BJQK40A%3D"

Response

200

application/json

Successful response

Key Response Fields:

• ads[0].advertiserId: Unique advertiser identifier (e.g. AR01614014350098432001)
• ads[0].creativeId: Unique creative identifier (e.g. CR16304891583101140993)
• ads[0].format: Ad format type (image, video, text)
• ads[0].adUrl: Direct link to the ad on Google Ads Transparency
• ads[0].advertiserName: Display name of the advertiser
• ads[0].domain: Advertiser's domain (e.g. lululemon.com)
• ads[0].imageUrl: URL of the ad's image (may be null)
• ads[0].firstShown: ISO 8601 timestamp of when the ad first ran
• ads[0].lastShown: ISO 8601 timestamp of when the ad last ran
• cursor: Opaque token to paginate to the next page of results