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

# 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`](https://parel.si/docs/tools/search_news.md) for coverage of a topic) and cannot read protected accounts; for Instagram use [`get_social_posts`](https://parel.si/docs/tools/get_social_posts.md).

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

```bash
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:

```json
{
  "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_posts`](https://parel.si/docs/tools/get_social_posts.md) for the same brand on Instagram.
- [`search_news`](https://parel.si/docs/tools/search_news.md) for what the press said.
