// fig. 01 — google search

Google Search API
for builders.

Real-time Google SERPs as structured JSON. Organic results, ads, knowledge graph, snippets, related searches — across 240+ Google domains, 190+ countries, every device.

Get API key Read the docs →

↓ scale240+ domains · 190+ countries

240+// google domains

190+// countries

<2s// avg response

API

// figure-02 — endpoint

One endpoint. Every shape of query.

One GET endpoint for every Google SERP. Control query, country, language, device, Google domain — every parameter Google's UI exposes, available as JSON.

// scenario

Pass q + country + hl + device. Get the parsed Google SERP for that exact locale and viewport.

GET/v1/google-search

// 03 · request

curl "https://api.serpyx.io/v1/google-search?\
q=best+running+shoes+2026&\
country=US&\
hl=en&\
device=mobile" \
  -H "Authorization: Bearer sk_live_..."

200OK · application/json

// 04 · response

{
  "search_metadata": {
    "status": "success",
    "google_url": "https://www.google.com/search?q=best+running+shoes+2026",
    "device": "mobile",
    "country": "US"
  },
  "search_parameters": { "q": "best running shoes 2026", "hl": "en" },
  "organic_results": [
    {
      "position": 1,
      "title": "Best Running Shoes of 2026, Tested by Runners",
      "link": "https://runnersworld.com/gear/best-running-shoes",
      "displayed_link": "runnersworld.com › gear",
      "snippet": "We tested 32 pairs across road, trail and track to find the top picks for 2026..."
    }
  ],
  "ads": [],
  "related_searches": ["best running shoes for flat feet", "marathon running shoes"]
}

Get API access Browse filters →

Filters

// capabilities

Built for SERP at scale

Live SERP fetching, residential proxy network, captcha solving and async batches — wired into your scheduler, RAG pipeline, or agent runtime via stable JSON.

// fig. 05─ ─ ─

Pull the full Google SERP in one call

Organic results, ads, snippets, knowledge graph, related searches — every Google SERP feature parsed and typed in a single response.

POST /people/search → buyers

current_title like "VP Sales"funding_stage = series_bsize in [201-500, 501-1000]

VP of Sales · Stripe

VP Sales · Series B SaaS

Match

Head of Sales · Notion

Head of Sales · 201-500

Match

VP RevOps · Figma

VP RevOps · Series B

Match

Matches12,480 SERPs / hr

// fig. 06─ ─ ─

Localize across 240+ Google domains

Country, language, Google domain, device — control every parameter that changes the SERP. Same request, any locale, any viewport.

agent.search(filters)

profile_country in [US, UK, CA]3.2M

profile_industry like Software412k

follower_count >= 1000184k

keyword like AI82k

Final list returned to agent

Matches190+ countries

// fig. 07─ ─ ─

Captchas and proxies handled

Residential, mobile and datacenter proxies. Auto-retry on failure, captcha solving baked in. Failed requests never billed.

past_company / school · in [...]

McKinsey & Company

Engagement Manager · 4 yrs

past_company

Bain & Company

Associate · 2 yrs

past_company

Stanford University

MS · Computer Science

school

MIT

PhD · AI

school

Matches9,820 retries / hr

// fig. 08─ ─ ─

Async batches at scale

Submit up to 100k queries in a single POST. We fan out across the proxy network and webhook the parsed JSON back when complete.

skill · in / certification · like

PythonMachine LearningAWS Certified Solutions ArchitectKubernetesPMPTypeScriptGCP ProfessionalPyTorchCISSPGoCFA Level IIIDistributed SystemsScrum MasterTerraform

Matches100k batch limit

Coverage

// fig. 10 — coverage

Coverage across 190+ countries

Residential, mobile and datacenter proxies across 190+ countries and 240+ Google domains — every SERP fetched live, every locale supported.

// dataset · global feed20+ points

// sources

20+

// refresh

live

// regions

global

Delivery

// fig. 11 — delivery

Data delivered where your stack lives.

Same SERP API, three transports. Pull on demand via REST, run async batches, or stream results back to your webhook.

// fig. 11REST

// channel

API

Pull on demand.

One GET request. Every Google SERP feature parsed. Authenticate with a Bearer token, point at the endpoint, get structured JSON back in under 2 seconds.

GET/v1/google-search

// notes

Bearer auth
JSON in, JSON out

// fig. 12BATCH

// channel

Async

Bulk SERP pulls.

Submit up to 100k queries in one POST. We fan out across the proxy network in parallel and webhook the parsed JSON back when ready — perfect for daily rank tracking.

POST/v1/batch

// notes

100k queries / batch
parallel proxy fan-out
webhook on completion

// fig. 13PUSH

// channel

Webhooks

Push results back to your stack.

Configure a webhook URL and we POST every async batch completion or scheduled SERP delta there — signed, retried with exponential backoff.

POST→ your_endpoint

// notes

signed payloads
exponential retry
batch + scheduled deltas

Use Cases

// fig. 14 — build surface

What can you build with our API.

One POST request, four product surfaces. Each layered on top of the same endpoint — only the question changes.

// fig. 15daily SERP pulls

Rank tracking platform

Pull positions for every keyword/country/device combo daily. Diff against the previous run, surface gainers and losers — captchas handled, residential proxies included.

// filters

qcountryhldevicegoogle_domain

// outputrank deltas → dashboard

// fig. 16live web retrieval

AI agent or RAG pipeline

Plug Serpyx in as a tool for Claude, GPT or Gemini. The agent issues queries, gets fresh JSON results back — no scraper to maintain, no proxy stack to babysit.

// filters

qnumcountryhlsafetbs

// outputfresh JSON → agent context

// fig. 17SERP feature ownership

SEO monitoring

Track who owns the featured snippet, knowledge graph, image pack and People Also Ask for every keyword. Capture ad copy, ad position and shopping ads in the same call.

// filters

qdevicecountrygoogle_domaintbs

// outputfeature ownership map

// fig. 18SERP mentions

Brand monitoring

Schedule daily Google Search and News pulls for every brand keyword across markets. Catch new pages, ranking shifts and ad bids on branded queries.

// filters

qcountryhltbstime

// outputmention feed → alert

Building something we haven't listed? Tell us what you're wiring it into. Half the columns we ship today came from a customer asking for one.

Compliance

GDPR compliant

We process only public web data — no PII storage, no user tracking. Full GDPR alignment with signed DPA available.

CCPA compliant

California Consumer Privacy Act ready. We never sell personal data and ship clear opt-out endpoints.

Public web data only

Our scrapers fetch the same SERPs you'd see in a browser — public, indexed, citation-friendly. No PII stored.

// see also

Ship in minutes. Not weeks.

Get an API key in 60 seconds. Pull your first Google SERP as structured JSON — no proxies, no captchas, no maintenance.

Get an API key Book a demo

↓ nextREST · JSON · Webhooks

Google Search API
for builders.

One endpoint. Every shape of query.