get_keyword_history
A keyword's monthly search volume, CPC and competition over past years. ₹1.37 per call; a result that finds nothing is ₹0.
What it does
Google search volume by month for each keyword, going back years, with cost per click and competition: data with one record per keyword and its monthly series, up to 100 keywords a call, in one market.
Use it to see seasonality and whether a category is growing or fading; keyword_volume gives today's monthly figure, keyword_data Google Trends' relative interest. Flat price per call whatever the count. Under five seconds.
India: location_code 2356.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
keywords | array of values | one of | Up to 100 keywords. |
language_code | string | no | Two-letter language code ("en"). |
location_code | integer | no | Market as a numeric code: 2356 is India. |
One of these sets must be complete (anything else is invalid_input, ₹0): keywords.
What drives the cost
Flat per call for up to 100 keywords. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.
Price today
| Price today | ₹1.37 per call (cost_paise: 137) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.06 (hold_paise: 206); 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: "get_keyword_history" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_keyword_history" |
| Confirmation | not 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":"get_keyword_history","input":{"keywords":["protein bar","cold pressed oil"],"language_code":"en","location_code":2356}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"items": [
{
"keyword": "cold pressed oil",
"history": [
{
"year": 2026,
"month": 8,
"keyword_info": {
"search_volume": 33100,
"cpc": 0.12,
"competition_level": "HIGH"
}
},
{
"year": 2026,
"month": 7,
"keyword_info": {
"search_volume": 33100,
"cpc": 0.14,
"competition_level": "HIGH"
}
},
{
"year": 2026,
"month": 6,
"keyword_info": {
"search_volume": 33100,
"cpc": 0.1,
"competition_level": "HIGH"
}
}
]
},
{
"keyword": "protein bar",
"history": [
{
"year": 2026,
"month": 9,
"keyword_info": {
"search_volume": 110000,
"cpc": 0.06,
"competition_level": "HIGH"
}
},
{
"year": 2026,
"month": 8,
"keyword_info": {
"search_volume": 90500,
"cpc": 0.05,
"competition_level": "HIGH"
}
},
{
"year": 2026,
"month": 7,
"keyword_info": {
"search_volume": 90500,
"cpc": 0.05,
"competition_level": "HIGH"
}
}
]
}
]
}
Notes
- Flat per call for up to 100 keywords.
- Monthly values from Google's own volume data; a keyword with no history returns no series.
- Pairs with keyword_volume (today) and keyword_data (relative trend).
Siblings
This page as Markdown: /docs/tools/get_keyword_history.md. Something wrong or missing: hello@parel.si.