get_keyword_ideas
Related keyword ideas for a seed keyword with volume, cost per click and competition, by country. ₹2.71 for the largest call (100 keywords); fewer settles lower.
What it does
Keyword ideas related to a seed keyword in a country, in data.items[], each with keyword_data (keyword, keyword_info.search_volume, cpc, competition_level, monthly_searches[]), up to limit (default 100 here), with data.total_count. Use it to expand a topic into the terms people search; for the volumes of keywords you already have keyword_volume, for where you rank rank_check.
India: location_code 2356 with language_code "en" or "hi".
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
depth | integer | no | 0-4, default 1. Breadth of the related-search crawl: 0 = seed only, 1 = ~8 keywords, 2 = ~72, 3 = ~584, 4 = ~4680. e.g. 1; max 2 |
limit | integer | no | 1-1000; default 100. e.g. 2; max 100 |
offset | integer | no | default 0 |
keyword | string | yes | seed keyword, lowercased by the API. e.g. "coffee" |
language_code | string | yes | one of language_code | language_name; must be a language Labs supports for that location. An unsupported pair returns 40501 Invalid Field, e.g. Mexico or Colombia with en (both take es) or Brazil with en (pt). e.g. "en" |
location_code | integer | yes | one of location_code | location_name; codes from the Labs locations list. 2840 = United States. e.g. 2840 |
ignore_synonyms | boolean | no | drop near-duplicate keywords; default false |
include_serp_info | boolean | no | attach SERP data per keyword; default false |
include_seed_keyword | boolean | no | default false |
include_clickstream_data | boolean | no | DOUBLES the cost; default false |
What drives the cost
limit: the source charges per request plus a small amount per keyword returned, so the price shown is for the largest call (100 keywords) and a smaller limit settles lower. depth 1 (default) explores about eight related searches, 2 about seventy; above 2, or limit above 100, is invalid_input, ₹0.
Price today
| Price today | ₹2.71 per call (cost_paise: 271) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹4.07 (hold_paise: 407); 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_ideas" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_keyword_ideas" |
| 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_ideas","input":{"depth":1,"limit":50,"keyword":"protein bar","language_code":"en","location_code":2356}}'
What comes back
data.items[] and data.total_count. A real answer recorded during the live check of 2026-10-28, trimmed to two keywords:
{
"se_type": "google",
"seed_keyword": "protein bar",
"seed_keyword_data": null,
"location_code": 2356,
"language_code": "en",
"total_count": 9,
"items_count": 9,
"items": [
{
"se_type": "google",
"keyword_data": {
"se_type": "google",
"keyword": "protein bar",
"location_code": 2356,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2026-10-19 10:58:12 +00:00",
"competition": 0.96,
"competition_level": "HIGH",
"cpc": 0.06,
"search_volume": 110000,
"low_top_of_page_bid": 0.01,
"high_top_of_page_bid": 0.33,
"categories": [
10011,
10089,
"… 2 more item(s) truncated"
],
"monthly_searches": [
{
"year": 2026,
"month": 9,
"search_volume": 135000
},
{
"year": 2026,
"month": 8,
"search_volume": 135000
},
"… 10 more item(s) truncated"
],
"search_volume_trend": {
"monthly": 0,
"quarterly": 0,
"yearly": 82
}
},
"keyword_info_normalized_with_bing": null,
"keyword_info_normalized_with_clickstream": null,
"clickstream_keyword_info": null,
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"synonym_clustering_algorithm": "text_processing",
"keyword_difficulty": 0,
"detected_language": "en",
"is_another_language": false
},
"serp_info": {
"se_type": "google",
"check_url": "https://www.google.com/search?q=protein%20bar&hl=en&gl=IN&ie=UTF-8&uule=w+CAIQICIFSW5kaWE",
"serp_item_types": [
"popular_products",
"people_also_ask",
"… 4 more item(s) truncated"
],
"se_results_count": 198,
"last_updated_time": "2026-07-12 17:26:28 +00:00",
"previous_updated_time": "2026-04-21 14:57:46 +00:00"
},
"avg_backlinks_info": {
"se_type": "google",
"backlinks": 39.9,
"dofollow": 35.6,
"referring_pages": 38.1,
"referring_domains": 12.7,
"referring_main_domains": 12.7,
"rank": 51.6,
"main_domain_rank": 448.4,
"last_updated_time": "2026-07-12 17:26:28 +00:00"
},
"search_intent_info": {
"se_type": "google",
"main_intent": "transactional",
"foreign_intent": null,
"last_updated_time": "2026-04-29 21:06:12 +00:00"
}
},
"depth": 0,
"related_keywords": [
"protein bar chocolate",
"max protein bar",
"… 6 more item(s) truncated"
]
},
{
"se_type": "google",
"keyword_data": {
"se_type": "google",
"keyword": "max protein bar",
"location_code": 2356,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2026-10-18 01:08:18 +00:00",
"competition": 0.95,
"competition_level": "HIGH",
"cpc": 0.04,
"search_volume": 33100,
"low_top_of_page_bid": 0.01,
"high_top_of_page_bid": 0.2,
"categories": [
10011,
10089,
"… 2 more item(s) truncated"
],
"monthly_searches": [
{
"year": 2026,
"month": 9,
"search_volume": 40500
},
{
"year": 2026,
"month": 8,
"search_volume": 49500
},
"… 10 more item(s) truncated"
],
"search_volume_trend": {
"monthly": -18,
"quarterly": 0,
"yearly": 49
}
},
"keyword_info_normalized_with_bing": null,
"keyword_info_normalized_with_clickstream": null,
"clickstream_keyword_info": null,
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"synonym_clustering_algorithm": "text_processing",
"keyword_difficulty": 0,
"detected_language": "en",
"is_another_language": false
},
"serp_info": {
"se_type": "google",
"check_url": "https://www.google.com/search?q=max%20protein%20bar&hl=en&gl=IN&ie=UTF-8&uule=w+CAIQICIFSW5kaWE",
"serp_item_types": [
"organic",
"popular_products",
"… 3 more item(s) truncated"
],
"se_results_count": 203,
"last_updated_time": "2026-09-08 09:19:50 +00:00",
"previous_updated_time": "2026-05-25 20:28:00 +00:00"
},
"avg_backlinks_info": {
"se_type": "google",
"backlinks": 79,
"dofollow": 61.8,
"referring_pages": 77,
"referring_domains": 28.8,
"referring_main_domains": 27.9,
"rank": 55.5,
"main_domain_rank": 320.8,
"last_updated_time": "2026-09-08 09:19:51 +00:00"
},
"search_intent_info": {
"se_type": "google",
"main_intent": "transactional",
"foreign_intent": null,
"last_updated_time": "2026-04-29 20:21:53 +00:00"
}
},
"depth": 1,
"related_keywords": [
"max protein bar price",
"max protein bar 30g",
"… 6 more item(s) truncated"
]
},
"… 7 more item(s) truncated"
]
}
Notes
- The shown price is the maximum (limit 100); fewer keywords settle lower. limit above 100 or depth above 2 is invalid_input (free).
- India: location_code 2356 (language_code "en" or "hi"); 2840 the United States.
- Usually one to two seconds.
Siblings
keyword_volumefor a list you already have.get_ranked_keywordsfor what a competitor ranks on.
This page as Markdown: /docs/tools/get_keyword_ideas.md. Something wrong or missing: hello@parel.si.