Google Ads API

Get Google Ads Keyword Planner ideas with search-volume ranges, competition and bid metrics through SpideyData's managed Google Ads API.

On this page

Google Ads API endpoints

Find the task you need. Each endpoint includes its parameters, request example, and response reference.

Research Google Ads keyword ideas and metrics

Request Keyword Planner suggestions and inspect the returned volume, competition and bid metrics.

Quick start

Submit typed keyword seeds and optional business filters. Browser, account, Cookie, token, and private RPC state stay server-side.

API base https://kieapi.com

curl -X POST "https://kieapi.com/v1/google-ads/keyword-ideas" \
  -H "Authorization: Bearer $SPIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["google ads"],
    "language_id": 1004,
    "location_ids": [2344],
    "network": 1,
    "currency_code": "HKD",
    "limit": 100
  }'

Authentication

Use a bearer token.

Team administrators manage API keys in Team Settings. Each key keeps its Team and billing scope when its creator leaves or switches Teams. Keys cannot manage members, billing or other keys. Public /v1 requests use Authorization: Bearer $SPIDER_API_KEY only; the Key's fixed Team is the payer. An optional X-Spider-Team-Id must match that Team or the request is denied. Creating, listing, rotating or revoking Keys through the product console (and other non-identity console business routes) requires X-Spider-Team-Id when the Team model is enabled; omitting it returns HTTP 409 team_context_required.

Response shape

Keyword ideas

Normalized text, search-volume range, competition, bid range, currency, and competition index.

Typed query

Echoes only the accepted keyword and business-filter fields.

Internal boundary

Account identifiers, DICloak profile ids, CDP URLs, Cookies, XSRF values, and raw Batch vectors are never exposed.

Temporary failures

Startup failures return HTTP 502 with google_ads_browser_unavailable and retryable=true. Failed requests release reserved Credits and are not charged.