News articles
The parsed list of news stories that cloro extracts from a Google News response, each carrying its headline, link, summary, publisher, timing, and optional thumbnail.
Overview
News articles are not a standalone request. They arrive inside the payload of the Google News extraction endpoint, so once you submit a Google News query you receive the parsed articles in the same response — there is no additional call to make.
Every entry in the newsResults array represents one story surfaced by Google News for your query. The objects are returned in the order Google presents them, and the position field lets you preserve or reconstruct that ranking downstream.
Article fields
| Field | Type | Description |
|---|---|---|
| position | number | Rank of the article within the news results, starting at 1. |
| title | string | Headline of the news story. |
| link | string | Destination URL for the full article. |
| snippet | string | Short excerpt summarizing the article's contents. |
| source | string | Name of the publisher or outlet that ran the story. |
| date | string | Human-readable publication time, such as "2 hours ago". |
| thumbnail | string | URL of the story's preview image; present only when Google supplies one. |
Example request
{
"query": "climate change",
"country": "US"
}Submitting a query like this to the Google News endpoint yields a response whose newsResults array holds the article objects described above.
Response example
{
"success": true,
"result": {
"newsResults": [
{
"position": 1,
"title": "Breaking climate news",
"link": "https://example.com/article",
"snippet": "Scientists report new findings on...",
"source": "Example News",
"date": "2 hours ago",
"thumbnail": "https://example.com/thumb.jpg"
}
]
}
}Notes
The thumbnail field can be absent for stories Google returns without an image, so treat it as optional when mapping results. If you run into unexpected gaps or malformed entries, reach out at [email protected].