/v1/trending"platform": "x"X (Twitter) Trending API
What is trending now.
Get what is trending on X now and get back title, rank and heat, as JSON over HTTP or from your AI client over MCP. A call to the X (Twitter) Trending API costs 6 credits ($0.012 to $0.02 depending on the pack), failed calls are free, and the response has the same format as every other call. Last tested 2026-11-04.
Last updated:
Daily watch: tell your AI “watch this daily” and this call runs by itself every day, sending only what is new: at most 186 credits a month, about $0.62. How to set it up
What you get from the X (Twitter) Trending API.
From a recorded answer.
A recorded call returned 30 items; here is the first, field by field. Names and text are removed from the sample; the numbers are as recorded.
| Field | In the recorded answer |
|---|---|
| title | removed from the sample |
| url | null: X cannot give it |
| rank | 1 |
| heat | null: X cannot give it |
6 credits a call (≈ $0.012–$0.02): about 500 calls for $10.
X (Twitter) Trending API: request and response
curl https://api.socialtoai.com/v1/trending \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "x" }'import osimport uuidimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/trending", headers={ "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}", # A new key for each request; the same one again retries it without paying twice. "Idempotency-Key": str(uuid.uuid4()), }, json={ "platform": "x", },)print(response.json())# Connected over MCP? Ask in plain words.What is trending on X right now?# Your AI calls the trending tool with:{ "platform": "x"}board{ "platform": "x", "status": "ok", "items": [ { "platform": "x", "id": null, "ref": null, "approx": [], "type": "entry", "entry_type": "trend", "title": "…", "url": null, "rank": 1, "heat": null, "fields": {} } ], "unavailable": ["id", "heat", "url"], "page": { "has_more": false }, "cost_credits": 6}nullNames and text were removed from the sample; the numbers are as recorded.
X (Twitter) Trending API parameters.
3 parameters, 1 required.
Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| platform | string | Required | — | Always "x" on this page. |
| board | string | Optional | "trends" | Which list: trends is the only one"trends" |
| region | string | Optional | — | Which country's trends, by its two-letter code: US, GB, CA, AU, IN, JP, DE, FR, BR or MX; worldwide when left out |
X (Twitter) Trending API response fields.
What X cannot give is marked.
| Field | Type | Meaning |
|---|---|---|
| items[].id | stringalways null | The platform's own ID. |
| items[].title | string | The entry's title or name. |
| items[].url | stringalways null | A link that opens it; null where the platform's list has none. |
| items[].rank | integer | Position on a board, from 1. |
| items[].heat | integeralways null | The platform's heat score. |
| items[].fields | object | Empty for a trend. |
nullFields X cannot giveRead null as “X did not give this”, not as zero. These are always null on this call:
idThe platform's own ID.urlA link that opens it; null where the platform's list has none.heatThe platform's heat score.
Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. Response format
X (Twitter) Trending API: paging and billing.
5 calls per second per key, 20 after a purchase; going over is not charged. Rate limits
A failed call costs 0 credits and is never retried on its own. Error codes
“Last tested” above is the last day a real call of this interface succeeded. Each call reads from the platform, and fetched_at in the answer is when it was read. The same request sent again with the same key within 5 minutes is a replay (replayed: true): 0 credits, and the answer as first read.
Once connected over MCP, these questions use the X (Twitter) Trending API.
What is trending on X right now?
6 creditstrending {"platform":"x"}
Give this to your AI.
Copy it into Claude or ChatGPT.
How to connectUse the SocialToAI MCP server (https://mcp.socialtoai.com/mcp) for this: What is trending on X right now?Call the trending tool with {"platform":"x"}. optional: board (trends), region.It gives its first page only, up to 30 items, with no next page; each call costs 6 credits.Before you start, work out how many credits it will take in all and ask me; call it only after I agree.If SocialToAI is not connected yet, tell me how to connect it; never ask me to paste a key into the chat.Answer with a link to every item you used, and tell me how many credits it cost.Paste it into a chat once SocialToAI is connected over MCP. There is no key in it: Claude and ChatGPT sign in, other clients send a key in a header.
Work scenarios that use it.
content-ideasYour AI reads what was posted on a subject this week and tells you which angles took off, with the posts, their numbers and what they have in common.
trend-watchingYour AI reads the trending lists and the posts that are taking off on a subject, and tells you what is rising, on which platform, with links.
The same call on other platforms.
All platforms and prices/v1/trending{ "platform": "x" }6 creditsper callRead next.
What its own API allows, who can use it and what it costs, with sources.
X's official prices, with sources, and reading X per call instead
Today's board in one list, refreshed daily.
Let your AI read X.