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.

FieldTypeRequiredDescription
qstringyese.g. "OpenAI"
glstringnoe.g. "us". default "us"
hlstringnoe.g. "en". default "en"
numintegernoRequested article count.; min 1, max 100
tbsstringnoGoogle date filter.
pageintegernodefault 1; min 1
locationstringno
autocorrectbooleannodefault 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_news"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_news"
Confirmationnot 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_web for the organic ranking.
  • read_page for an article's full text.
  • get_reddit for 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.