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

# get_x_trending

> The topics trending on X in a country right now, with post counts. ₹0.20 per call; a result that finds nothing is ₹0.

## What it does

What is trending on X in one country at the time of the call: data with the trending topics and hashtags, their post counts where X shows them and their category.

Use it to catch a conversation early or to see whether a campaign tag made the list; [`search_x`](https://parel.si/docs/tools/search_x.md) reads the posts under a topic, [`get_reddit_trending`](https://parel.si/docs/tools/get_reddit_trending.md) the Reddit equivalent. Flat price per call. One to three seconds.

India: country "India" gives X's India trends.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `country` | string | no | The country as one word ("India", "UnitedStates", "UnitedKingdom"). |

## What drives the cost

Flat per call; the list as it stands. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.20** per call (`cost_paise: 20`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); 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_x_trending"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_x_trending"` |
| 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_x_trending","input":{"country":"India"}}'
```

## What comes back

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

```json
{
  "trends": [
    {
      "name": "#CristianoRonaldo",
      "description": null,
      "context": "Sports · Trending"
    },
    {
      "name": "#2017SeJagmagAyodhya",
      "description": null,
      "context": "Trending"
    },
    {
      "name": "#Nav_Sankalp",
      "description": null,
      "context": "Politics · Trending"
    }
  ]
}
```

## Notes

- Flat per call; the list as it stands.
- Country names are written as one word: India, UnitedStates, UnitedKingdom.
- Pairs with search_x to read the posts behind a trend.

## Siblings

- [`search_x`](https://parel.si/docs/tools/search_x.md)
- [`get_reddit_trending`](https://parel.si/docs/tools/get_reddit_trending.md)
