Google News API

Live headlines from news.google.com, with publisher URLs, topics, and clusters.

Free tier, 200 requests a month
No credit card
Structured JSON
Live pages, fetched per call

Start free View documentation

Data samples

From the page to JSON

The page the Google News API reads, and the response it returns for the same query.

topic

WORLD

country

Try it live

https://news.google.com/topics/CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx1YlY4U0FtVnVHZ0pWVXlnQVAB?hl=en-NZ&gl=NZ&ceid=NZ:en

{
  "engine": "google_news",
  "family": "news",
  "format": "html",
  "query": {
    "q": null,
    "when": null,
    "topic": "WORLD",
    "language": "en",
    "country": "nz",
    "page": 1
  },
  "title": "World",
  "count": 1,
  "next_cursor": null,
  "results": [
    {
      "position": 1,
      "title": "North Korean operative posing as IT contractor hired by NZ business",
      "url": "https://www.1news.co.nz/2026/09/24/north-korean-operative-posing-as-it-contractor-hired-by-nz-business/",
      "google_url": "https://news.google.com/read/CBMiEXAMPLE",
      "source": {
        "name": "1News",
        "domain": "1news.co.nz"
      },
      "published_at": "2026-09-24T17:03:04.000Z",
      "authors": [
        "Ed O'driscoll"
      ]
    }
  ]
}

Source page captured separately from the recorded response, so live values can differ.

Code

Integrate in minutes

One host, one Bearer key for every Clair API. Each call returns JSON with the same envelope, so a second API is a new path, not a new client.

Get an API key Read the docs

curl -G "https://api.clair.im/v1/search?engine=google_news&topic=WORLD&country=nz" \
  -H "Authorization: Bearer YOUR_API_KEY"

Reference

Query and response fields

One listing page. HTML results include publisher url and google_url. RSS search keeps only the Google /read/ link. Do not send limit or cursor.

GET /v1/search?engine=google_news

Authorization header · stringrequired: Bearer <api_key>. Create keys under API keys.
engine stringrequired: Must be google_news.
q string: Search query. Omit for home, topic, or token listings.
when string: With q: 1h, 1d, 7d, or 1y.
topic string: HEADLINES, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, or HEALTH.
topic_token string: Google News /topics/<token> from the listing.
section_token string: Needs topic_token or publication_token.
story_token string: Full Coverage cluster from results[].story.story_token.
publication_token string: Publisher page from results[].source.publication_token.
location string: Geo section slug, e.g. New York.
language string: ISO 639-1. Default en. Maps to Google News hl.
country string: ISO 3166-1 alpha-2. Default us. Maps to gl/ceid.
page integer: Must be 1. Google News returns one listing page.

Pricing

Simple plans, free to start

This API is its own subscription with its own quota. Unused requests expire at renewal. Need a custom volume? Email contact@serinlabs.com.

Free

$0/mo

200

Requests / month

Overage: Hard limit
Rate limit: 10/min
Card: Not needed

Start for free

Pro

$49.99/mo

3,700

Requests / month

Overage: $0.0134 per extra request
Rate limit: 5/sec
Stops at: 18,500 requests

Ultra

$149/mo

14,800

Requests / month

Overage: $0.0101 per extra request
Rate limit: 10/sec
Stops at: 44,400 requests

Mega

$399/mo

49,600

Requests / month

Overage: $0.0081 per extra request
Rate limit: 20/sec
Stops at: 124,000 requests

Pay as you go

No monthly fee

$0.0201

Per request

Overage: None
Rate limit: 5/sec
Stops at: 18,500 requests

Prices in USD, billed monthly by Stripe. Cancel any time from Manage billing.

FAQ

Common questions

Anything else? Email contact@serinlabs.com.

What does the Google News API return?

Live scrape of news.google.com. Home, search, named topics, geo, publisher pages, and Full Coverage stories. HTML listings include the real publisher URL plus google_url. Search may fall back to RSS (format=rss) when Google bans the HTML page. Article bodies are not hydrated.

How is a request counted?

Each call is one request, and each extra page is a new call. A malformed request (400) is not counted, and a request that fails on our side (5xx) is refunded.

Is there a free tier?

Yes. Every Clair API has its own free tier: 200 requests a month, with no card. It resets monthly, and the API stops when the month's requests run out.

What happens when I use up my plan's requests?

On a paid tier, extra calls are billed at the tier's overage rate until its ceiling, then the API returns 429 until the next period. The free tier returns 429 as soon as its requests are used.

Does this subscription cover other Clair APIs?

No. Each API is its own subscription, and one key works with all of them. A call to an API the account does not subscribe to returns 403 not_subscribed.

Related APIs

APIs teams often combine with the Google News API.

Bloomberg News API

Section rails or site search on bloomberg.com, then one article.

View API →

Associated Press API

AP section hubs, topic hubs, or site search, then one article.

View API →

Reuters News API

List a reuters.com section or author, then fetch one article.

View API →

Subscribe to the API you need.

Each Clair API is its own monthly request quota. Unused requests expire. Every API has a free tier to try it.

Get API Key →Compare plans

Google News API

Live headlines from news.google.com, with publisher URLs, topics, and clusters.

Free tier, 200 requests a month
No credit card
Structured JSON
Live pages, fetched per call

Start free View documentation

Data samples

From the page to JSON

The page the Google News API reads, and the response it returns for the same query.

topic

WORLD

country

Try it live

https://news.google.com/topics/CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx1YlY4U0FtVnVHZ0pWVXlnQVAB?hl=en-NZ&gl=NZ&ceid=NZ:en

{
  "engine": "google_news",
  "family": "news",
  "format": "html",
  "query": {
    "q": null,
    "when": null,
    "topic": "WORLD",
    "language": "en",
    "country": "nz",
    "page": 1
  },
  "title": "World",
  "count": 1,
  "next_cursor": null,
  "results": [
    {
      "position": 1,
      "title": "North Korean operative posing as IT contractor hired by NZ business",
      "url": "https://www.1news.co.nz/2026/09/24/north-korean-operative-posing-as-it-contractor-hired-by-nz-business/",
      "google_url": "https://news.google.com/read/CBMiEXAMPLE",
      "source": {
        "name": "1News",
        "domain": "1news.co.nz"
      },
      "published_at": "2026-09-24T17:03:04.000Z",
      "authors": [
        "Ed O'driscoll"
      ]
    }
  ]
}

Source page captured separately from the recorded response, so live values can differ.

Code

Integrate in minutes

One host, one Bearer key for every Clair API. Each call returns JSON with the same envelope, so a second API is a new path, not a new client.

Get an API key Read the docs

curl -G "https://api.clair.im/v1/search?engine=google_news&topic=WORLD&country=nz" \
  -H "Authorization: Bearer YOUR_API_KEY"

Reference

Query and response fields

One listing page. HTML results include publisher url and google_url. RSS search keeps only the Google /read/ link. Do not send limit or cursor.

GET /v1/search?engine=google_news

Authorization header · stringrequired: Bearer <api_key>. Create keys under API keys.
engine stringrequired: Must be google_news.
q string: Search query. Omit for home, topic, or token listings.
when string: With q: 1h, 1d, 7d, or 1y.
topic string: HEADLINES, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, or HEALTH.
topic_token string: Google News /topics/<token> from the listing.
section_token string: Needs topic_token or publication_token.
story_token string: Full Coverage cluster from results[].story.story_token.
publication_token string: Publisher page from results[].source.publication_token.
location string: Geo section slug, e.g. New York.
language string: ISO 639-1. Default en. Maps to Google News hl.
country string: ISO 3166-1 alpha-2. Default us. Maps to gl/ceid.
page integer: Must be 1. Google News returns one listing page.

Pricing

Simple plans, free to start

This API is its own subscription with its own quota. Unused requests expire at renewal. Need a custom volume? Email contact@serinlabs.com.

Free

$0/mo

200

Requests / month

Overage: Hard limit
Rate limit: 10/min
Card: Not needed

Start for free

Pro

$49.99/mo

3,700

Requests / month

Overage: $0.0134 per extra request
Rate limit: 5/sec
Stops at: 18,500 requests

Ultra

$149/mo

14,800

Requests / month

Overage: $0.0101 per extra request
Rate limit: 10/sec
Stops at: 44,400 requests

Mega

$399/mo

49,600

Requests / month

Overage: $0.0081 per extra request
Rate limit: 20/sec
Stops at: 124,000 requests

Pay as you go

No monthly fee

$0.0201

Per request

Overage: None
Rate limit: 5/sec
Stops at: 18,500 requests

Prices in USD, billed monthly by Stripe. Cancel any time from Manage billing.

FAQ

Common questions

Anything else? Email contact@serinlabs.com.

What does the Google News API return?

How is a request counted?

Each call is one request, and each extra page is a new call. A malformed request (400) is not counted, and a request that fails on our side (5xx) is refunded.

Is there a free tier?

Yes. Every Clair API has its own free tier: 200 requests a month, with no card. It resets monthly, and the API stops when the month's requests run out.

What happens when I use up my plan's requests?

On a paid tier, extra calls are billed at the tier's overage rate until its ceiling, then the API returns 429 until the next period. The free tier returns 429 as soon as its requests are used.

Does this subscription cover other Clair APIs?

No. Each API is its own subscription, and one key works with all of them. A call to an API the account does not subscribe to returns 403 not_subscribed.

Related APIs

APIs teams often combine with the Google News API.

Bloomberg News API

Section rails or site search on bloomberg.com, then one article.

View API →

Associated Press API

AP section hubs, topic hubs, or site search, then one article.

View API →

Reuters News API

List a reuters.com section or author, then fetch one article.

View API →

Subscribe to the API you need.

Each Clair API is its own monthly request quota. Unused requests expire. Every API has a free tier to try it.

Get API Key →Compare plans