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.0When 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.
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" } }'
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
querystringrequirededition"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:ensitestringwhen"1h" | "1d" | "7d"after or before.afterstringbeforestringafter, a span of days.Record
Each record of results, in the envelope every call returns (Run an operation).
objectstringidstringpositionintegertitlestringurlstringamp_urlstringpublished_atdateafter/before).publisher.namestringpublisher.sitestringpublisher.iconstringpublisher.idstringpublisher.google_news_urlstringauthorslistimage.urlstringimage.google_urlstringimage.widthintegerimage.heightintegerstory.titlestringstory.positionintegerids.article_idstringgoogle_news_urlstringsource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_query | 422 | query takes 1 to 500 characters. |
invalid_edition | 422 | An edition is COUNTRY:language, as Google News writes it: US:en, FR:fr. |
invalid_site | 422 | site is a domain: reuters.com. |
invalid_time | 422 | when takes 1h, 1d or 7d; after and before are days (YYYY-MM-DD); not when with them. |
site_challenge | 503 | Google asked to prove a person is there; retry in a minute (not charged). Retryable. |
site_unavailable | 503 | Google did not answer in time or refused the call; retry later (not charged). Retryable. |
unexpected_answer | 424 | Google 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-13id 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