search_news
Recent news articles for a query from Google News, by country and language. ₹0.20 per call; an empty list is ₹0.
What it does
Recent articles about a company, person or topic: title, source, date, snippet, link and image, ranked, in data.news[]. For evergreen web pages use search_web; for the full text of one article use read_page.
India: gl: "in" and hl: "en" (or "hi"); location: "Mumbai, India" biases local coverage. The defaults are the United States and English.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
q | string | yes | e.g. "OpenAI" |
gl | string | no | e.g. "us". default "us" |
hl | string | no | e.g. "en". default "en" |
num | integer | no | Requested article count.; min 1, max 100 |
tbs | string | no | Google date filter. |
page | integer | no | default 1; min 1 |
location | string | no | |
autocorrect | boolean | no | default true |
What drives the cost
Nothing: the price is flat per call whatever num says, so ask for the number of articles you need (up to 100) and use page for more. tbs narrows by date (qdr:d, qdr:w, qdr:m); a filter that is too tight returns an empty list, which is ₹0 for you.
Price today
| Price today | ₹0.20 per call (cost_paise: 20) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (hold_paise: 38); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "search_news" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "search_news" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"search_news","input":{"q":"Reliance Jio","gl":"in","hl":"en","num":10}}'
What comes back
data.news[], newest and most relevant first. A recorded answer from the source, trimmed to two items; through Parel it arrives as data:
{
"news": [
{
"title": "Australia launches urgent review after OpenAI program hacks government health portal",
"link": "https://www.bbc.com/news/live/cvgl73pxgndwt",
"date": "4 hours ago",
"source": "BBC",
"imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTyz4IZyJjp7v_xKgqtaFUN1UtgO9ieNBva8cInuBqu_rUMYrUB8qc2mQI&usqp=CAI&s"
},
{
"title": "OpenAI's breach of Australian health department website prompts rebuke",
"link": "https://www.npr.org/2026/09/24/g-s1-144835/openai-breach-australia",
"date": "9 hours ago",
"source": "NPR",
"imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSvHUSc5xPsckW5IeoXUVDzxxzbN9jSzPm3wcjfrrhiqr5CKOfqaNQuQjk&usqp=CAI&s"
},
"… 14 more"
]
}
Notes
- num is a request, not a guarantee: Google News may return fewer. An empty news[] is free.
- tbs date filters that are too tight return nothing; widen before retrying.
- India: gl "in", hl "en" or "hi"; location "Mumbai, India" biases local coverage.
Siblings
search_webfor the organic ranking.read_pagefor an article's full text.get_redditfor what a community says rather than what the press writes.
This page as Markdown: /docs/tools/search_news.md. Something wrong or missing: hello@parel.si.