// fig. 01 — google news

Google News API
in real time.

Scrape Google News headlines, articles and stories as structured JSON. Time-window filters, story clusters, 190+ markets — fresh in seconds.

↓ scalereal-time · 190+ markets
190+// markets
<2s// avg response
99.99%// uptime
API
// figure-02 — endpoint

One request. Headlines, parsed and dated.

Search any topic, restrict the time window, group by story cluster — every field of the Google News SERP available as JSON.

Pass a query and we return the parsed Google News SERP — headline, snippet, source, date, thumbnail.

GET/v1/google-news
// 03 · request
curl "https://api.serpyx.io/v1/google-news?q=OpenAI&hl=en&country=US" \
  -H "Authorization: Bearer sk_live_..."
200200 OK · application/json
// 04 · response
{
  "search_metadata": { "status": "success" },
  "news_results": [
    {
      "position": 1,
      "title": "OpenAI announces new model lineup at DevDay 2026",
      "source": { "name": "TechCrunch", "icon": "https://..." },
      "link": "https://techcrunch.com/2026/05/01/...",
      "snippet": "The new lineup focuses on agentic workloads and...",
      "date": "2 hours ago",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/..."
    }
  ]
}
Capabilities
// capabilities

Every news SERP signal, exposed as a parameter.

Topic, time window, story cluster, country, language — control everything Google's UI exposes, programmatically.

// fig. 05─ ─ ─

Topic & section

Target World, Business, Tech, Sports, Entertainment, Health or any custom Google News section.

// filters
topicsectionpublication
// fig. 06─ ─ ─

Time window

Last hour, last day, last week, last month — or a precise date range. Maps directly to Google's `tbs`.

// filters
timetbsfrom_dateto_date
// fig. 07─ ─ ─

Story clusters

Group related coverage across publications into a single story — with recency, sentiment and source diversity.

// filters
storiesstory_tokenrelated_coverage
// fig. 08─ ─ ─

Geo & language

Country and language target the locale-specific edition of Google News — 190+ markets, 80+ languages.

// filters
countryhlglgoogle_domain
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 Logo

GDPR compliant

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

CCPA Logo

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.

Related
Get Started
// fig. ∞ — ship

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.

↓ nextREST · JSON · Webhooks