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, for its size get_x_profile.
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
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:
{
"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_postfor one post's exact numbers.search_redditfor the same topic on Reddit.
This page as Markdown: /docs/tools/search_x.md. Something wrong or missing: hello@parel.si.