Skip to content
Google News

Search articles

The articles of a Google News search, up to 100, as Google ranks them, each with its publisher's URL.

google_news/articles/search100 credits a callv2.0.0

When to use it

You need the news articles Google News shows for a query: title, the publisher's URL, publication time, publisher, authors, image, and the story Google groups it in. One call is one search of at most 100 articles, ranked by relevance, with no next page: narrow it by time (when, or after/before for days) or by site, and call once per period for more. Google News gives no summary of an article's text.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
The words to search, as typed in Google News' search box; its operators work ("exact words", OR, -word).
One of Google News' 90 editions, COUNTRY:language as Google writes it (its "Language & region" menu): US:en by default, GB:en, FR:fr, DE:de, IN:en, BR:pt-419...
Only the articles of this publisher's domain (lemonde.fr, reuters.com).
Only the articles of the last hour, day or week.
Only the articles published from this day (YYYY-MM-DD), which Google reads in US Pacific time.
Only the articles published before this day (YYYY-MM-DD, US Pacific time).
100 credits a call
Code, from the fields above
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "google_news",
    "operation": "articles/search",
    "options": {
      "query": "artificial intelligence",
      "when": "1d"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_wfhggo4gntunmkqio3b2ozam2e",
  "livemode": true,
  "source": "google_news",
  "operation": "articles/search",
  "version": "2.0.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/google_news/articles/search",
  "options": {
    "query": "artificial intelligence",
    "when": "1d"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": false,
  "next": null,
  "cost": {
    "credits": 100
  },
  "results": [
    {
      "object": "article",
      "id": "3f9a1c27b84e5d06",
      "position": 1,
      "title": "An example article on artificial intelligence",
      "url": "https://www.example-news.com/2026/11/12/ai-example",
      "amp_url": null,
      "published_at": "2026-11-12T13:53:07Z",
      "publisher": {
        "name": "Example News",
        "site": "https://www.example-news.com",
        "icon": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.example-news.com",
        "id": "CAAqExamplePublisherId",
        "google_news_url": "https://news.google.com/publications/CAAqExamplePublisherId"
      },
      "authors": [
        {
          "name": "Jane Doe",
          "google_news_url": null
        }
      ],
      "image": {
        "url": "https://img.example-news.com/ai.jpg",
        "google_url": "https://news.google.com/api/attachments/CC8iExample",
        "width": 664,
        "height": 426
      },
      "story": null,
      "ids": {
        "article_id": "CBMiExampleArticleId"
      },
      "google_news_url": "https://news.google.com/read/CBMiExampleArticleId?hl=en-US&gl=US&ceid=US%3Aen",
      "source_url": "https://news.google.com/search?q=artificial%20intelligence%20when%3A1d&hl=en-US&gl=US&ceid=US%3Aen",
      "observed_at": "2026-11-12T16:00:00Z"
    }
  ]
}

Options

querystringrequired
The words to search, as typed in Google News' search box; its operators work ("exact words", OR, -word).
edition"AU:en" | "BW:en" | "CA:en" | "ET:en" | "GH:en" | "IN:en" | "ID:en" | "IE:en" | "IL:en" | "KE:en" | "LV:en" | "MY:en" | "NA:en" | "NZ:en" | "NG:en" | "PK:en" | "PH:en" | "SG:en" | "ZA:en" | "TZ:en" | "UG:en" | "GB:en" | "US:en" | "ZW:en" | "ID:id" | "MY:ms" | "ES:ca" | "CZ:cs" | "DE:de" | "AT:de" | "CH:de" | "EE:et" | "AR:es-419" | "CL:es-419" | "CO:es-419" | "CU:es-419" | "ES:es" | "US:es-419" | "MX:es-419" | "PE:es-419" | "VE:es-419" | "BE:fr" | "CA:fr" | "FR:fr" | "MA:fr" | "SN:fr" | "CH:fr" | "IT:it" | "LV:lv" | "LT:lt" | "HU:hu" | "BE:nl" | "NL:nl" | "NO:no" | "PL:pl" | "BR:pt-419" | "PT:pt-150" | "RO:ro" | "SK:sk" | "SI:sl" | "FI:fi" | "SE:sv" | "VN:vi" | "TR:tr" | "GR:el" | "BG:bg" | "RU:ru" | "UA:ru" | "RS:sr" | "UA:uk" | "IL:he" | "AE:ar" | "SA:ar" | "LB:ar" | "EG:ar" | "IN:mr" | "IN:hi" | "BD:bn" | "IN:bn" | "IN:pa" | "IN:gu" | "IN:ta" | "IN:te" | "IN:ml" | "TH:th" | "CN:zh-Hans" | "TW:zh-Hant" | "HK:zh-Hant" | "JP:ja" | "KR:ko"Default US:en
One of Google News' 90 editions, COUNTRY:language as Google writes it (its "Language & region" menu): US:en by default, GB:en, FR:fr, DE:de, IN:en, BR:pt-419... Google ranks and picks the articles for that edition's readers.
sitestring
Only the articles of this publisher's domain (lemonde.fr, reuters.com).
when"1h" | "1d" | "7d"
Only the articles of the last hour, day or week. Not with after or before.
afterstring
Only the articles published from this day (YYYY-MM-DD), which Google reads in US Pacific time. The articles of a search by day carry their day, not their hour (Google cuts their time to the day's midnight, Pacific).
beforestring
Only the articles published before this day (YYYY-MM-DD, US Pacific time). With after, a span of days.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
idstring
The article's id: 16 characters, the same for its publisher's URL in every search and edition. Google's own id is ids.article_id.
positioninteger
Its place in Google's ranking; a story's articles in their story's place.
titlestring
The title
urlstring
The article at its publisher's (never Google's link).
amp_urlstring
Its AMP page, when the publisher has one.
published_atdate
When it was published, UTC (a day's midnight, Pacific, in a search by after/before).
publisher.namestring
publisher.sitestring
The publisher's site: https://www.lemonde.fr.
publisher.iconstring
Its icon, as Google News shows it.
publisher.idstring
Google News' id of the publisher, the same on all its articles; null for some smaller ones.
publisher.google_news_urlstring
The publisher's page on Google News.
authorslist
The authors Google News names (about half the articles), each with their Google News page when it has one.
image.urlstring
The image at its publisher's.
image.google_urlstring
Google's copy of it, as the page shows it.
image.widthinteger
image.heightinteger
story.titlestring
Google's heading of the story.
story.positioninteger
The article's place in its story, 1 to 3.
ids.article_idstring
Google News' id of the article (CBMi...), the one in its own links: about 250 characters.
google_news_urlstring
The article's link on Google News.
source_urlstring
The search on news.google.com these values were read from.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_query422query takes 1 to 500 characters.
invalid_edition422An edition is COUNTRY:language, as Google News writes it: US:en, FR:fr.
invalid_site422site is a domain: reuters.com.
invalid_time422when takes 1h, 1d or 7d; after and before are days (YYYY-MM-DD); not when with them.
site_challenge503Google asked to prove a person is there; retry in a minute (not charged). Retryable.
site_unavailable503Google did not answer in time or refused the call; retry later (not charged). Retryable.
unexpected_answer424Google answered in a shape we do not read yet; we are told and fix it, and it is not charged.

Price

100 credits a call, whatever the search holds. An empty search and a failed call are free. What a credit costs on each plan: Credits and pricing.

Changelog

2.0.02026-11-13
id is now short: 16 characters, the same for an article's publisher URL in every search and edition. Google's own id (CBMi..., about 250 characters, 44 % of an answer) moves to ids.article_id. A search of 100 articles with a few fields now fits what an agent reads in one call.
1.0.02026-11-12
First version on the API v2: one Google News search of up to 100 articles, as Google ranks them, each with its publisher's URL, time, publisher, authors, image and story; by edition, site, the last hour, day or week, or days.