get_x_posts
Recent posts of a public X (Twitter) account with likes, reposts, replies and views, and a cursor for more. ₹0.18 per page; a protected or missing account is ₹0.
What it does
About twenty recent posts from one public X account's Posts tab, from its handle (without the @), in data.tweets[]: text, url, createdUtc, likes, retweets, replies, quotes, views, bookmarks, media[], isReply, isPinned and lang, with data.nextCursor to page further by sending it back as cursor. Use it to see what an account has said lately; it does not search X by keyword (use search_news for coverage of a topic) and cannot read protected accounts; for Instagram use get_social_posts.
India: any public account.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
cursor | string | no | Opaque pagination cursor from a previous response's nextCursor. Omit for the first page. |
handle | string | yes | Twitter/X handle without the leading @.. e.g. "levelsio" |
What drives the cost
Nothing: flat per page. A protected, suspended or missing account is class: "ok_free", ₹0. Responses are small (around 20 KB), so nothing is cut over MCP.
Price today
| Price today | ₹0.18 per page (cost_paise: 18) 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_posts" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_x_posts" |
| 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_posts","input":{"handle":"narendramodi"}}'
What comes back
data.tweets[] and data.nextCursor. A real answer recorded during the live check of 2026-10-28, trimmed to two posts:
{
"nextCursor": "cur_lgVWabxY5ubRgfKCgxPMmw",
"tweets": [
{
"authorHandle": "narendramodi",
"authorId": "18839785",
"authorImage": "https://pbs.twimg.com/profile_images/2090480155240378368/suu43duO_normal.jpg",
"authorName": "Narendra Modi",
"bookmarks": 48,
"conversationId": "2115262280254513560",
"createdUtc": 1793152801,
"id": "2115262280254513560",
"isPinned": null,
"isReply": false,
"lang": "sa",
"likes": 4229,
"media": [
{
"height": 1080,
"type": "video",
"url": "https://pbs.twimg.com/media/HVppyJ1bsAAAFE-.jpg",
"videoUrl": "https://video.twimg.com/amplify_video/2115118998304284673/vid/avc1/1920x1080/8iKC4w7FeJXxIi1s.mp4?tag=29",
"width": 1920
}
],
"quotes": 67,
"replies": 623,
"retweets": 1316,
"source": "",
"text": "पालयन् प्रकृतिं राजा सुखी भवति नान्यथा।\n\nप्रकृतिश्च हिता यस्य स राजा सर्वकामधुक्॥ https://t.co/vWlZwpNEI0",
"url": "https://x.com/i/web/status/2115262280254513560",
"views": 329014
},
{
"authorHandle": "narendramodi",
"authorId": "18839785",
"authorImage": "https://pbs.twimg.com/profile_images/2090480155240378368/suu43duO_normal.jpg",
"authorName": "Narendra Modi",
"bookmarks": 66,
"conversationId": "2115108727963742619",
"createdUtc": 1793116192,
"id": "2115108727963742619",
"isPinned": null,
"isReply": false,
"lang": "en",
"likes": 7862,
"media": [
{
"type": "photo",
"url": "https://pbs.twimg.com/media/HVpfrKXaYAAdDUj.jpg"
},
{
"type": "photo",
"url": "https://pbs.twimg.com/media/HVpfsAma4AAoTNF.jpg"
},
"… 2 more item(s) truncated"
],
"quotes": 35,
"replies": 292,
"retweets": 1604,
"source": "",
"text": "Had an excellent meeting with His Serene Highness Hereditary Prince Alois of Liechtenstein.\n\nOur discussions were wide-ranging and focused on strengthening India-Liechtenstein relations across several sectors. \n\nWe reviewed the progress under the historic India-EFTA Trade and Economic Partnership Agreement (TEPA), which has completed its first year and discu…",
"url": "https://x.com/i/web/status/2115108727963742619",
"views": 493692
},
"… 18 more item(s) truncated"
]
}
Notes
- About 20 posts per page; pass data.nextCursor back as cursor for the next page. Each page is a call.
- Protected, suspended or missing accounts return nothing, which is free.
- Responses are small (around 20 KB).
Siblings
get_social_postsfor the same brand on Instagram.search_newsfor what the press said.
This page as Markdown: /docs/tools/get_x_posts.md. Something wrong or missing: hello@parel.si.