search_x_users

X accounts matching a keyword in handle, name or bio, with follower counts. ₹0.18 per page; a result that finds nothing is ₹0.

What it does

Accounts on X matching a keyword in their handle, name or bio, as X's People tab lists them: data with each account's handle, name, bio, follower, following and post counts and verification, plus a cursor for the next page.

Use it to find the people and brands talking about a subject before reading them with get_x_posts; search_x searches the posts, search_creators finds creators across platforms. Flat price per page; nothing matching is free. Two to five seconds.

India: put India or a city in the query.

Inputs

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

FieldTypeRequiredDescription
querystringyesA keyword matched against handles, names and bios ("D2C founder India").
cursorstringnoThe cursor from the previous answer, for the next page.

What drives the cost

Flat per page; pass cursor for the next page. A result that finds nothing is class: "ok_free", ₹0. The timeout is 90 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
Timeout90 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_x_users"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_x_users"
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_users","input":{"query":"startup founder"}}'

What comes back

data, as the live check of 2026-11-05 recorded it, trimmed:

{
  "nextCursor": "cur_rvBwDBDULaub-ynByF2gAA",
  "users": [
    {
      "avatarUrl": "(picture link removed)",
      "bio": "I quit my job at a big bank to build startups.\n\n🧲 https://t.co/1XWVaQ4vIA get users/leads\n🧠 https://t.co/k1SBWgHFp8 mindset → results\n💻 https://t.co/VdeoVLAfEr websites & AI",
      "canDm": true,
      "coverUrl": "(picture link removed)",
      "createdUtc": 1719320834,
      "followers": 26148,
      "following": 17522,
      "id": "1805588499925553153",
      "listedCount": 139,
      "location": "go steal whatever helps →",
      "name": "A User 58",
      "posts": 250752,
      "profileUrl": "https://x.com/alexabelonix",
      "username": "a_user_59",
      "verified": true
    },
    {
      "avatarUrl": "(picture link removed)",
      "bio": "START LAND Founder CEO | 自社クリエイティブスタジオ | 最先端技術開発 | メタバース & Game開発 | ソフトウェア開発 | AI開発 | Web3 & Web4 開発 | 2D & 3D & アニメーション制作 | 地方創生事業 | 包括連携協定締結済み 高知市 岡崎市 美祢市",
      "canDm": false,
      "coverUrl": "(picture link removed)",
      "createdUtc": 1641200032,
      "followers": 29096,
      "following": 2707,
      "id": "1477926119043379202",
      "listedCount": 120,
      "location": "philippines",
      "name": "A User 60",
      "posts": 27415,
      "profileUrl": "https://x.com/KzcHArt",
      "username": "a_user_61",
      "verified": true
    },
    {
      "avatarUrl": "(picture link removed)",
      "bio": "India’s most vibrant startup incubator. Live, build, and learn together under one roof in Bangalore. Home to @India2047VC, our frontier tech incubator.",
      "canDm": true,
      "coverUrl": "(picture link removed)",
      "createdUtc": 1350025050,
      "followers": 4541,
      "following": 770,
      "id": "875085030",
      "listedCount": 113,
      "location": "Bangalore",
      "name": "A User 62",
      "posts": 4600,
      "profileUrl": "https://x.com/founders_house",
      "username": "a_user_63",
      "verified": true
    }
  ]
}

Notes

  • Flat per page; pass cursor for the next page.
  • Matches handles, names and bios, not posts: search_x for posts.
  • Nothing matching is free.
  • Short, plain queries work best (a name, a brand, a role); a long phrase can match nobody, which is free.

Siblings

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