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.

FieldTypeRequiredDescription
limitintegernoPage 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
querystringyese.g. "openai"
cursorstringnoOpaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of search results.
queryTypestringnoResult 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 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: "search_x"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_x"
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":"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

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