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.

FieldTypeRequiredDescription
cursorstringnoOpaque pagination cursor from a previous response's nextCursor. Omit for the first page.
handlestringyesTwitter/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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_x_posts"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_x_posts"
Confirmationnot 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

This page as Markdown: /docs/tools/get_x_posts.md. Something wrong or missing: hello@parel.si.