# Google Search Ad API (https://www.socialcrawl.dev/platforms/google/ad)

> Returns detailed information about a specific Google advertisement including ad copy, advertiser, and format.

TL;DR: `GET /v1/google/ad` 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 |
| --- | --- | --- |
| `url` | yes | Ads Transparency Center CREATIVE URL — must include both the advertiser and creative segments (`…/advertiser/{AR…}/creative/{CR…}`). Get one from `/v1/google/company/ads`. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01614014350098432001%2Fcreative%2FCR10449491775734153217" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a specific Google ad with an API?

Send a GET request to /v1/google/ad with the full Ads Transparency Center URL in the url parameter. SocialCrawl returns the ad record — creative (image, video, or text), advertiser name, format, and the date range the ad was active on Google surfaces.

### Where do I get the Google ad URL from?

Ad URLs come from the Google Ads Transparency Center (adstransparency.google.com) or from the adlibrary/advertisers/search and company/ads endpoints, which return ad URLs in their results. Run a search first, then fan out to this endpoint for each ad you want full detail on.

### What fields does the Google Ad API return?

Ad creative URL (image, video, or text assets), advertiser name and verified status, ad format, first and last seen timestamps, regions where the ad ran, and the raw ad-specific metadata Google exposes publicly in the Transparency Center.

### Can I pull every ad from one advertiser?

Use the company/ads endpoint with the advertiser domain or advertiser_id to list every ad they've run. Then call /v1/google/ad with each ad URL to drill into the full creative and metadata. This is the standard two-step pattern for competitor ad monitoring.

### How much does the Google Ad API cost?

Each request costs 5 credits on the advanced tier because ad data requires heavier upstream rendering. New accounts get 100 free credits — enough to pull 20 Google ad records at full detail before paying, or 100 SERP queries if you mix and match.

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 get Google Ads Transparency Center ad details with an API
- What does the SocialCrawl Google Ad endpoint return?