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

# 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`](https://parel.si/docs/tools/get_x_posts.md); [`search_x`](https://parel.si/docs/tools/search_x.md) searches the posts, [`search_creators`](https://parel.si/docs/tools/search_creators.md) 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

```bash
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:

```json
{
  "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

- [`get_x_posts`](https://parel.si/docs/tools/get_x_posts.md)
- [`search_x`](https://parel.si/docs/tools/search_x.md)
- [`search_creators`](https://parel.si/docs/tools/search_creators.md)
