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

# search_news_backup

> A second source for search_news: google News results, newest first, any country. ₹0.20 per call; a result that finds nothing is ₹0.

## What it does

A second source for [`search_news`](https://parel.si/docs/tools/search_news.md), from a different data provider: google News results, newest first, any country. The answer is this provider's own, so its field names differ from [`search_news`](https://parel.si/docs/tools/search_news.md)'s: read the example answer, not [`search_news`](https://parel.si/docs/tools/search_news.md)'s docs.

Use it when [`search_news`](https://parel.si/docs/tools/search_news.md) fails; [`search_news`](https://parel.si/docs/tools/search_news.md) stays the first choice. It reads the same platform through another provider, so it helps when the first one is down or blocked, not when the platform has nothing. It is a separate call at its own price: it is billed per call when it answers; a failed or empty call is free.

India: gl "in" and hl "en" (or "hi"); the defaults are the United States and English.

## Inputs

Generated from the contract captured from staging on 2026-11-18.

| Field | Type | Required | Description |
|---|---|---|---|
| `q` | string | yes | News search query; supports operators like '-', 'OR', and 'site:' (e.g. bitcoin site:cnn.com).. e.g. "openai" |
| `gl` | string | no | Two-letter country code for result localization (e.g. us, gb, de).. e.g. "us". default "us" |
| `hl` | string | no | Two-letter interface and results language code (e.g. en, es, de).. e.g. "en". default "en" |
| `num` | integer | no | Caps the result rows returned; `_truncated` says how many were withheld. Not the charge.; min 0 |
| `limit` | integer | no | Requested article count (1-20, default 20). Google News returns its latest matching articles and may return more or fewer than requested. Price is flat per request.; min 1, max 20 |
| `location` | string | no | Fine-grained location for result localization, given as a canonical Google location string (e.g. 'New York, United States', 'London, United Kingdom'). More specific than the country-level gl. |
| `timeframe` | string | no | How far back to search, written as a count plus a unit: h hours, d days, w weeks, m months, y years. So 2h is the last two hours, 30d the last thirty days, 6m the last six months. Omit this field, or send 'all', to search without a time limit. |

## What drives the cost

Flat price per call. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## 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_backup"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_news_backup"` |
| 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_backup","input":{"q":"Reliance Jio","gl":"in","hl":"en","num":10}}'
```

## What comes back

`data`, as the live check of 2026-11-18 recorded it, trimmed:

```json
{
  "items": [
    {
      "createdUtc": 1794967430,
      "image": "https://etimg.etb2bimg.com/thumb/msid-135945389,width-1600,height-900,resizemode-4/.jpg",
      "snippet": "Opensignal's latest report reveals Reliance Jio leads in 5G download speeds while Airtel excels in upload speeds and availability,...",
      "source": "ET Telecom",
      "title": "Jio tops in 5G download speeds; Airtel, Vodafone Idea lead charts in 5G upload: Opensignal",
      "url": "https://telecom.economictimes.indiatimes.com/news/industry/jio-tops-in-5g-download-speeds-airtel-vodafone-idea-lead-charts-in-5g-upload-opensignal/135945389"
    },
    {
      "createdUtc": 1794909483,
      "image": "https://www.advanced-television.com/wp-content/uploads/2024/12/relianceJio.png",
      "snippet": "Reliance Jio Platforms is building a 1,600-satellite mega-constellation, and is reportedly in talks with India's Space Research Organisation...",
      "source": "Advanced Television",
      "title": "Reliance Jio weighs up launch options",
      "url": "https://www.advanced-television.com/2026/11/17/reliance-jio-weighs-up-launch-options/"
    },
    {
      "createdUtc": 1794978269,
      "image": "https://img-cdn.publive.online/fit-in/1200x675/telenet/media/post_attachments/wp-content/uploads/2025/12/17.jpg",
      "snippet": "According to the latest Opensignal findings, Reliance Jio and Bharti Airtel shared the top spots across mobile network experience categories...",
      "source": "tele.net",
      "title": "Jio leads on overall and 5G download speeds, while Airtel and Vi top 5G upload speed, says Opensignal report",
      "url": "https://tele.net.in/national-news/jio-leads-on-overall-and-5g-download-speeds-while-airtel-and-vi-top-5g-upload-speed-says-opensignal-report-12819135"
    }
  ]
}
```

## Notes

- Second source for search_news: call search_news first, this one after a failure.
- Field names differ from search_news's; inputs keep search_news's names where they mean the same thing.

## Siblings

- [`search_news`](https://parel.si/docs/tools/search_news.md)
