POST
$0.01 default
/v1/newsDescription
News search: live Google News results for a query, localised by location and language. Returns ranked articles with title, URL, domain and, where available, source and timestamp. Current events and headlines for agents.
Pricing
$0.01 default
Request schema
{
"additionalProperties": false,
"properties": {
"language": {
"description": "Language code (2-letter). Defaults to en.",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"limit": {
"description": "Depth / maximum results. Defaults to 10.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"location": {
"description": "Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States.",
"maxLength": 120,
"minLength": 2,
"type": "string"
},
"q": {
"description": "Search query.",
"maxLength": 700,
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
}Example response
{
"results": [
{
"domain": "reuters.com",
"rank": 1,
"source": "Reuters",
"timestamp": "2026-01-15 09:30:00 +00:00",
"title": "Markets rally as inflation cools more than expected",
"url": "https://www.reuters.com/markets/2026/01/15/markets-rally-inflation/"
}
],
"total": 84
}