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 does), and it is not a rank check (rank_check). 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.

FieldTypeRequiredDescription
countrystringnofilter; default 'us'; ISO country code; mapped to geo / location code
keywordsarray of valuesone ofidentity

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 whenit fails: ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "keyword_data"
Over RESTPOST https://api.parel.si/v1/run with "tool": "keyword_data"
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":"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:

{
  "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

This page as Markdown: /docs/tools/keyword_data.md. Something wrong or missing: hello@parel.si.