Skip to main content
GET
/
v1
/
scrape
/
google-ad-library
/
company-ads
Company Ads
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/google-ad-library/company-ads \
  --header 'X-API-Key: <api-key>'
{
  "ads": [
    {
      "advertiserId": "AR10397446976948928513",
      "creativeId": "CR00429437544950661121",
      "firstShown": "2025-06-28T00:00:00.000Z",
      "lastShown": "2025-08-11T23:46:18.000Z",
      "format": "text",
      "overallImpressions": {
        "min": "<unknown>",
        "max": "<unknown>"
      },
      "creativeRegions": [
        {
          "regionCode": "FI",
          "regionName": "Finland"
        }
      ],
      "regionStats": [
        {
          "regionCode": "FI",
          "regionName": "Finland",
          "firstShown": "2025-06-30T00:00:00.000Z",
          "lastShown": "2025-08-11T00:00:00.000Z",
          "impressions": {},
          "platformImpressions": [
            "<unknown>"
          ]
        }
      ],
      "variations": [
        {
          "destinationUrl": "www.scrapingbee.com/",
          "headline": "Switch to #1 Web Scraping API",
          "description": "ScrapingBee API handles rotating proxies, headless browsers and CAPTCHAS."
        }
      ]
    }
  ],
  "cursor": "CgoAP7znHvOD%2BtxDEhCPtIenS6VuEst4VJkAAAAAGgn8%2BJRa%2BLT01FM%3D",
  "success": true,
  "statusCode": 200
}
💳 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

Successful response

​
ads
object[]
required
​
cursor
string
required
Example:

"CgoAP7znHvOD%2BtxDEhCPtIenS6VuEst4VJkAAAAAGgn8%2BJRa%2BLT01FM%3D"

​
success
boolean
required
Example:

true

​
statusCode
integer
required
Example:

200