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

# search_x

> Posts on X (Twitter) matching a keyword or advanced query: text, author, likes, reposts, views, with a cursor for more. ₹0.18 per page; no matches is ₹0.

## What it does

Posts on X matching `query`, in `data.items[]`: `text`, `url`, `createdUtc`, `authorUsername`, `authorName`, `authorFollowers`, `authorVerified`, `likeCount`, `retweetCount`, `replyCount`, `viewCount` and `media`, about twenty per page, with `data.nextCursor` for `cursor`. The query takes X's advanced-search syntax: bare words are ANDed, so use one short phrase or `OR` between alternatives; `from:`, `since:`, `until:` and `min_faves:` work. Use it to see what people say about a brand or topic; for one account's own posts [`get_x_posts`](https://parel.si/docs/tools/get_x_posts.md), for its size [`get_x_profile`](https://parel.si/docs/tools/get_x_profile.md).

India: add the market or a Hindi word to the query; there is no country knob.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | Page size to ask for (1-50, default 20). Some sources honor it; others always return their whole native page of about 20. A page is never trimmed after the call, so follow nextCursor to continue exactly where this response ended.. e.g. 20. default 20; min 1, max 50 |
| `query` | string | yes | e.g. "openai" |
| `cursor` | string | no | Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of search results. |
| `queryType` | string | no | Result ranking: 'Latest', 'Top', 'Photos', or 'Videos' (e.g. Latest).. default "Latest" |

## What drives the cost

Nothing: flat per page. No matches is `class: "ok_free"`, ₹0. Usually two to three seconds.

## 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: "search_x"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_x"` |
| 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":"search_x","input":{"limit":20,"query":"mamaearth"}}'
```

## What comes back

`data.items[]` and `data.nextCursor`. A real answer recorded during the live check of 2026-10-28, trimmed to two posts:

```json
{
  "items": [
    {
      "authorFollowers": 289229,
      "authorId": "1045737414625382400",
      "authorImage": "https://pbs.twimg.com/profile_images/1421347808527863810/YKnv6CPS_normal.jpg",
      "authorName": "DealzTrendz",
      "authorUsername": "dealztrendz",
      "authorVerified": true,
      "bookmarkCount": 1,
      "conversationId": "2115305592508096528",
      "createdUtc": 1793163128,
      "id": "2115305592508096528",
      "inReplyToId": null,
      "isReply": false,
      "lang": "en",
      "likeCount": 6,
      "media": [],
      "quoteCount": 0,
      "replyCount": 0,
      "retweetCount": 0,
      "text": "GRAB : Extra 10% Off on Baby essentials from Sebamed, Aveeno Baby & Mamaearth\n\nSebamed Baby Body Lotion pH 5.5 (100 ml) ₹504 : https://t.co/JCvUYhq3pD \nSebamed Baby Shampoo pH 5.5 (150 ml) ₹474 :  https://t.co/phx1ZJw3f3 \n\nAveeno Baby Daily Moisturizing Lotion (100 g) ₹470 :  https://t.co/XZavNoyUyN \nAveeno Baby Daily Cleansing Bar Pack of 3 (White) ₹513 :  …",
      "url": "https://x.com/i/web/status/2115305592508096528",
      "viewCount": 29658
    },
    {
      "authorFollowers": 21012,
      "authorId": "1307849715145347073",
      "authorImage": "https://pbs.twimg.com/profile_images/1914754353652469760/-xx7rL1Y_normal.jpg",
      "authorName": "MysteryDealz",
      "authorUsername": "Mysterydealz",
      "authorVerified": true,
      "bookmarkCount": 0,
      "conversationId": "2115305591841120609",
      "createdUtc": 1793163128,
      "id": "2115305591841120609",
      "inReplyToId": null,
      "isReply": false,
      "lang": "en",
      "likeCount": 0,
      "media": [],
      "quoteCount": 0,
      "replyCount": 0,
      "retweetCount": 0,
      "text": "GRAB : Extra 10% Off on Baby essentials from Sebamed, Aveeno Baby & Mamaearth\n\nSebamed Baby Body Lotion pH 5.5 (100 ml) ₹504 : https://t.co/dLHBbgYptB \nSebamed Baby Shampoo pH 5.5 (150 ml) ₹474 :  https://t.co/3cZnzsPFEp \n\nAveeno Baby Daily Moisturizing Lotion (100 g) ₹470 :  https://t.co/LQMrBDig7s \nAveeno Baby Daily Cleansing Bar Pack of 3 (White) ₹513 :  …",
      "url": "https://x.com/i/web/status/2115305591841120609",
      "viewCount": 862
    },
    "… 18 more item(s) truncated"
  ],
  "nextCursor": "cur_neBNJXZGPA02q8r7qGAm9w"
}
```

## Notes

- Bare words are ANDed: one short phrase, or OR between alternatives. Operators from:, since:, until:, min_faves: work.
- About 20 posts per page; pass data.nextCursor back as cursor. No matches is free.
- Usually two to three seconds.

## Siblings

- [`get_x_post`](https://parel.si/docs/tools/get_x_post.md) for one post's exact numbers.
- [`search_reddit`](https://parel.si/docs/tools/search_reddit.md) for the same topic on Reddit.
