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.
| Field | Type | Required | Description |
|---|---|---|---|
query | string | yes | A keyword matched against handles, names and bios ("D2C founder India"). |
cursor | string | no | The 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 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 | 90 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "search_x_users" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "search_x_users" |
| 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_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.