Docs — Google Ads

Start here

Introduction

The Google Ads API on AdScrape gives you the same data the dashboard renders, exposed as a small REST surface. Every call returns JSON with consistent envelopes — there are no XML or form-encoded responses. Google Ads Transparency API endpoints and examples.

REST + JSON
UTF-8 JSON in/out. One envelope for success and errors.
Advertiser typeahead
Resolve a partial brand to the right Google advertiser_id with one call.
Multi-surface coverage
Search, Display and YouTube placements share a single creative envelope.
Pay per ad returned
1 credit / creative delivered. Suggestions are 1 credit per result block.
No Google API quota
We talk to the Transparency Center directly. No Cloud project, no allowlist.
Soft launch
Google routes are preview today — billing flips on at GA.

0 → first response in 60 seconds

Quickstart

1. Create a key. Settings → API Keys → Create. Copy the sk_live_… once — you won't see it again.
2. Resolve the advertiser. Hit /google/suggestions with the brand name to get a stable advertiser_id.
3. Scrape creatives. Pass the advertiser_id + region to /google/search.

bash

# 1. Resolve advertiser
curl -X POST https://api.adscrape.in/api/v1/google/suggestions \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"query":"shopify"}'

# 2. Scrape
curl -X POST https://api.adscrape.in/api/v1/google/search \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"advertiser_id":"AR1234567890","region":"US","max_results":25}'

Auth

Authentication

Every call requires a key in the X-API-Key header (or a Bearer JWT from a dashboard session). Manage keys at Settings → API Keys.

bash

curl -X POST https://api.adscrape.in/api/v1/google/search \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"advertiser_id":"AR123","region":"US"}'

Treat keys like passwords. Anything that calls this API with your key spends your credits. Rotate from Settings → API Keys if you suspect a leak.

Pricing

Credits & pricing

Credit pricing is identical across AdScrape platforms — one wallet, transparent USD rates. Reads from cached records you already own are free. Topping up is per-credit with no monthly minimum.

EndpointPer-call rateUSDNotes

POST /api/v1/google/search
per ad returned
$0.05 / ad
Charged only for delivered creatives. Empty pages cost 0.
POST /api/v1/google/suggestions
per result block
$0.01 / suggestion
Cached 1h on (query, region). Cache hits are free.

Throughput

Rate limits

Limits apply per API key in 60-second windows. 429 responses include Retry-After. Need higher? Add a bring-your-own proxy and the cap lifts considerably.

PlanReq / minNotes

Free
30
Plenty for occasional research.
Starter
60
Daily competitive monitoring across a few brands.
Growth
120
Agencies and growing teams.
Scale
600
Bulk pipelines and warehouse-feeding jobs.

Error model

Error responses

Errors share a single envelope shape. A 5xx mid-request never debits you — credits are charged only after the response is successfully streamed.

StatusReasonMeaning

400validation_error
Bad body / query. Detail names the offending field.
401missing_key
No X-API-Key header and no valid JWT cookie.
402insufficient_credits
Wallet would go negative — top up or upgrade.
404advertiser_not_found
Google has no records for the advertiser_id + region pair.
429rate_limited
Per-minute cap exceeded. Honour Retry-After.
502upstream_error
Google Transparency Center returned a transient error. Retry with backoff.

Endpoint

Advertiser suggestions

POST/api/v1/google/suggestions 1 credit / batch

Resolve a partial advertiser name into Google's stable advertiser_id. Use the id from this response for the cleanest /search results.

Request body

FieldTypeDescription

queryrequired
string
1–80 chars. Partial brand or company name.
regionoptional
string
ISO 3166-1 alpha-2 region — affects ranking.Defaults to "US".
limitoptional
integer
Number of suggestions (1–20).Defaults to 5.

Request

bash

curl -X POST https://api.adscrape.in/api/v1/google/suggestions \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query":"shopify","limit":5}'

Response

application/json200 OK

{
  "suggestions": [
    { "advertiser_id": "AR1029384756", "name": "Shopify Inc.",  "region": "US", "verified": true },
    { "advertiser_id": "AR9988776655", "name": "Shopify Plus",  "region": "US", "verified": true },
    { "advertiser_id": "AR1122334455", "name": "Shop Pay",      "region": "US", "verified": false }
  ],
  "cached": true
}

Endpoint

Search creatives

POST/api/v1/google/search 1 credit / ad

Scrape Google Transparency Center creatives for one advertiser × region pair. Returns Search, Display, and YouTube units in a single normalized schema.

Request body

FieldTypeDescription

advertiser_idrequired
string
Google advertiser_id from /google/suggestions.
regionrequired
string
ISO 3166-1 alpha-2 region code.
formatoptional
string
"search" | "display" | "video" | "all".Defaults to "all".
max_resultsoptional
integer
1–100. Playground clamps to 5.Defaults to 25.
session_tokenoptional
string
Pagination cursor from the previous response.

Request

bash

curl -X POST https://api.adscrape.in/api/v1/google/search \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"advertiser_id":"AR1029384756","region":"US","max_results":25}'

Response

application/json200 OK

{
  "summary": { "count": 23, "advertiser_id": "AR1029384756", "region": "US" },
  "ads": [
    {
      "ad_archive_id": "g_AR1029_d_abc",
      "advertiser": "Shopify Inc.",
      "format": "display",
      "headline": "Start your store today",
      "destination_url": "https://shopify.com/free-trial",
      "first_seen": "2026-02-11T14:00:00Z",
      "last_seen": "2026-05-10T22:00:00Z",
      "media_url": "https://api.adscrape.in/m/g_AR1029_d_abc"
    }
  ],
  "session_token": "g_sess_4a1c...",
  "has_more": true
}

Next steps

The dashboard, your keys, and your billing live one tab away.

API keysCreate, rotate, scope by RPM PlaygroundTry this API in 60s, no key required Billing & creditsPlans, top-ups, ledger Google overviewBack to the platform tour Usage analyticsPer-key, per-endpoint, per-day ContactSales, support, or partnerships

Looking for the master reference? AdScrape's full cross-platform docs cover billing, webhooks, and shared schemas at /docs.

# 1. Resolve advertiser curl -X POST https://api.adscrape.in/api/v1/google/suggestions \ -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -d '{"query":"shopify"}' # 2. Scrape curl -X POST https://api.adscrape.in/api/v1/google/search \ -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"advertiser_id":"AR1234567890","region":"US","max_results":25}'

curl -X POST https://api.adscrape.in/api/v1/google/search \ -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"advertiser_id":"AR123","region":"US"}'

curl -X POST https://api.adscrape.in/api/v1/google/suggestions \ -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"query":"shopify","limit":5}'

{ "suggestions": [ { "advertiser_id": "AR1029384756", "name": "Shopify Inc.", "region": "US", "verified": true }, { "advertiser_id": "AR9988776655", "name": "Shopify Plus", "region": "US", "verified": true }, { "advertiser_id": "AR1122334455", "name": "Shop Pay", "region": "US", "verified": false } ], "cached": true }

{ "summary": { "count": 23, "advertiser_id": "AR1029384756", "region": "US" }, "ads": [ { "ad_archive_id": "g_AR1029_d_abc", "advertiser": "Shopify Inc.", "format": "display", "headline": "Start your store today", "destination_url": "https://shopify.com/free-trial", "first_seen": "2026-02-11T14:00:00Z", "last_seen": "2026-05-10T22:00:00Z", "media_url": "https://api.adscrape.in/m/g_AR1029_d_abc" } ], "session_token": "g_sess_4a1c...", "has_more": true }

Build with Google ads.

Introduction

Quickstart

Authentication

Credits & pricing

Rate limits

Error responses

Advertiser suggestions

Search creatives

Next steps

Build with Google ads.

Introduction

Quickstart

Authentication

Credits & pricing

Rate limits

Error responses

Advertiser suggestions

Search creatives

Next steps