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

# get_search_intent

> Each keyword's search intent: informational, navigational, commercial or transactional, with a probability. ₹1.41 per call; a result that finds nothing is ₹0.

## What it does

What people mean by each keyword: data with, for every keyword you send, the main intent (informational, navigational, commercial or transactional) and the probability of each, up to 200 keywords a call.

Use it to sort a keyword list before writing pages or bidding: the commercial and transactional ones sell, the informational ones teach; [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md) grows the list and [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md) prices it. Flat price per call whatever the count. Under five seconds.

India: intent is language-based; send Hindi keywords with language_code "hi".

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `keywords` | array of values | one of | Up to 200 keywords. |
| `language_code` | string | no | Two-letter language code ("en"). |

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

## What drives the cost

Flat per call for up to 200 keywords: batch them. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.41** per call (`cost_paise: 141`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.12 (`hold_paise: 212`); 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_search_intent"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_search_intent"` |
| 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_search_intent","input":{"keywords":["protein bar","buy protein bar online","what is whey protein"],"language_code":"en"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "items_count": 3,
  "items": [
    {
      "keyword": "protein bar",
      "keyword_intent": {
        "label": "transactional",
        "probability": 0.6321
      },
      "secondary_keyword_intents": null
    },
    {
      "keyword": "buy protein bar online",
      "keyword_intent": {
        "label": "transactional",
        "probability": 1
      },
      "secondary_keyword_intents": null
    },
    {
      "keyword": "what is whey protein",
      "keyword_intent": {
        "label": "informational",
        "probability": 1
      },
      "secondary_keyword_intents": null
    }
  ]
}
```

## Notes

- Flat per call for up to 200 keywords: batch them.
- Four intents with probabilities; the main one is the highest.
- Pairs with keyword_volume and get_keyword_ideas.

## Siblings

- [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md)
- [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md)
