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

# keyword_data

> Google Trends interest over time for up to five keywords on one scale, by country. ₹1.70 per call; an empty series is ₹0.

## What it does

Relative Google Trends interest (0 to 100) over time for one or more keywords in a country, in `data.output.series[]`: each series lists its `keywords`, a `data[]` of weekly points (`date_from`, `date_to`, `values[]` in keyword order) and the `averages`. Pass up to five keywords in one `keywords` list to compare them on one scale. It does not give absolute search volumes, cost per click or difficulty ([`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md) does), and it is not a rank check ([`rank_check`](https://parel.si/docs/tools/rank_check.md)). `data.output` is the whole answer.

India: `country: "in"`; the default is the United States.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `country` | string | no | filter; default 'us'; ISO country code; mapped to geo / location code |
| `keywords` | array of values | one of | identity |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `keywords`.

## What drives the cost

Nothing you can turn: flat per call whatever the number of keywords (up to five). The price shown is the dearest route the source may take; the charge settles at what the serving route cost, usually less. An empty series is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹1.70** per call (`cost_paise: 170`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.55 (`hold_paise: 255`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails: ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "keyword_data"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "keyword_data"` |
| 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":"keyword_data","input":{"country":"in","keywords":["upi","credit card"]}}'
```

## What comes back

`data.output.series[]`, one series for the keywords sent. A real answer recorded during the live check of 2026-10-28, trimmed to two points:

```json
{
  "output": {
    "series": [
      {
        "position": 1,
        "keywords": [
          "upi",
          "credit card"
        ],
        "data": [
          {
            "date_from": "2025-11-02",
            "date_to": "2025-11-08",
            "timestamp": 1762041600,
            "values": [
              28,
              95
            ]
          },
          {
            "date_from": "2025-11-09",
            "date_to": "2025-11-15",
            "timestamp": 1762646400,
            "values": [
              23,
              97
            ]
          },
          "… 50 more item(s) truncated"
        ],
        "averages": [
          23,
          81
        ]
      }
    ]
  }
}
```

## Notes

- The price shown is the dearest route; the charge settles at what the serving provider cost, usually less.
- Relative interest only (0 to 100), no absolute volumes.
- Up to five keywords per call, compared on one scale; an empty series is free.
- India: country "in".

## Siblings

- [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md) for absolute monthly volumes.
- [`rank_check`](https://parel.si/docs/tools/rank_check.md) for where you rank on them.
