> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_news

# 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`](https://parel.si/docs/tools/search_web.md); for the full text of one article use [`read_page`](https://parel.si/docs/tools/read_page.md).

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

```bash
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`:

```json
{
  "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`](https://parel.si/docs/tools/search_web.md) for the organic ranking.
- [`read_page`](https://parel.si/docs/tools/read_page.md) for an article's full text.
- [`get_reddit`](https://parel.si/docs/tools/get_reddit.md) for what a community says rather than what the press writes.
