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 reads the posts under a topic, get_reddit_trending 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
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:
{
"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
This page as Markdown: /docs/tools/get_x_trending.md. Something wrong or missing: hello@parel.si.