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

# 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`](https://parel.si/docs/tools/keyword_volume.md), for where you rank [`rank_check`](https://parel.si/docs/tools/rank_check.md).

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

```bash
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:

```json
{
  "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_volume`](https://parel.si/docs/tools/keyword_volume.md) for a list you already have.
- [`get_ranked_keywords`](https://parel.si/docs/tools/get_ranked_keywords.md) for what a competitor ranks on.
