# Google Search Company Ads API (https://www.socialcrawl.dev/platforms/google/company-ads)

> Returns ads from a specific company/domain in the Google Ads Transparency Center. Each ad includes creative, format, and date range.

TL;DR: `GET /v1/google/company/ads` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `domain` | no | Company domain name to look up ads for |
| `advertiser_id` | no | The advertiser id of the company |
| `topic` | no | The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU' (all \| political) |
| `region` | no | The region to search for. Defaults to anywhere |
| `start_date` | no | Start date to search for. Format: YYYY-MM-DD |
| `end_date` | no | End date to search for. Format: YYYY-MM-DD |
| `platform` | no | Google surface to filter ads by (e.g. youtube, google_search) (google_maps \| google_play \| google_search \| google_shopping \| youtube) |
| `format` | no | Ad format to filter by: text, image, or video (text \| image \| video) |
| `get_ad_details` | no | Set to true to get the ad details. Will cost 25 credits. |
| `cursor` | no | Cursor to paginate through results |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google/company/ads" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list every ad a company has run on Google?

Send a GET request to /v1/google/company/ads with either the company domain in the domain parameter or the advertiser_id from the advertiser search endpoint. SocialCrawl returns every ad the company has run in the Google Ads Transparency Center with creative URLs and dates.

### What filters does the company ads endpoint support?

Six optional filters: domain or advertiser_id (one required), topic (all or political — political also needs region like US or AU), region (two-letter country code), start_date and end_date (YYYY-MM-DD), and cursor for pagination through long advertiser histories.

### Can I pull political ads specifically?

Yes. Pass topic=political along with a region (e.g. US, AU, IN) to scope results to political advertising. The Transparency Center exposes extra metadata on political ads — funding entity, regions targeted — and SocialCrawl passes it through on the standard ad record.

### How do I paginate through a long advertiser history?

The response includes a cursor token when more pages exist. Pass the cursor value back as the cursor parameter on the next request to fetch the next page. Repeat until the cursor is empty to walk through the advertiser's full history in the Transparency Center.

### How much does the Google Company Ads API cost?

Each request costs 5 credits on the advanced tier. Passing get_ad_details=true adds 25 credits to inline full ad detail for every ad in the response (skipping a fan-out). New accounts get 100 free credits, so you can run 20 company ad pulls before paying.

See the full Google Search API: https://www.socialcrawl.dev/platforms/google

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list every ad a company has run on Google with an API
- What does the SocialCrawl Google Company Ads endpoint return?