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

# get_x_followers

> A page of one X account's followers: handle, name, bio and follower count. ₹0.20 per page; a result that finds nothing is ₹0.

## What it does

The followers of one public X account, a page at a time: data with each follower's handle, name, bio, follower count and verification, plus a cursor for the next page.

Use it to understand who follows a brand or a competitor and to find notable accounts among them; [`get_x_profile`](https://parel.si/docs/tools/get_x_profile.md) gives the count, [`search_x_users`](https://parel.si/docs/tools/search_x_users.md) finds accounts by keyword. Public lists of public accounts, under the Acceptable Use Policy: for understanding an audience, not for building contact lists. Flat price per page; a protected or unknown account is free. Two to six seconds.

India: any public account.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `cursor` | string | no | The cursor from the previous answer, for the next page. |
| `screen_name` | string | yes | The account's handle, without the @. |

## What drives the cost

Flat per page; pass cursor for the next page. A protected or unknown account is free. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.20** per page (`cost_paise: 20`) 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: "get_x_followers"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_x_followers"` |
| 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":"get_x_followers","input":{"screen_name":"Flipkart"}}'
```

## What comes back

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

```json
{
  "followers_count": 2855662,
  "followers": [
    {
      "user_id": "986828524936990721",
      "screen_name": "realmeIndia",
      "description": null,
      "profile_image": "(picture link removed)",
      "statuses_count": null,
      "followers_count": 832018,
      "friends_count": null,
      "media_count": null,
      "created_at": "Thu Apr 19 04:47:09 +0000 2018",
      "can_dm": null,
      "location": "India",
      "blue_verified": false,
      "verified": false,
      "website": null,
      "name": "realme",
      "affiliates": [],
      "business_account": null
    },
    {
      "user_id": "2460859956",
      "screen_name": "motorolaindia",
      "description": null,
      "profile_image": "(picture link removed)",
      "statuses_count": null,
      "followers_count": 529121,
      "friends_count": null,
      "media_count": null,
      "created_at": "Thu Apr 24 06:06:13 +0000 2014",
      "can_dm": null,
      "location": "India",
      "blue_verified": false,
      "verified": false,
      "website": null,
      "name": "Motorola India",
      "affiliates": [],
      "business_account": null
    },
    {
      "user_id": "950950601961062400",
      "screen_name": "a_user_55",
      "description": null,
      "profile_image": "(picture link removed)",
      "statuses_count": null,
      "followers_count": 581855,
      "friends_count": null,
      "media_count": null,
      "created_at": "Wed Jan 10 04:41:06 +0000 2018",
      "can_dm": null,
      "location": "India",
      "blue_verified": true,
      "verified": false,
      "website": null,
      "name": "a_user_55",
      "affiliates": [],
      "business_account": null
    }
  ],
  "next_cursor": "1880993215479103775|2118357967022587832",
  "status": "ok",
  "more_users": true
}
```

## Notes

- Flat per page; pass cursor for the next page. A protected or unknown account is free.
- Public accounts only; handles and bios, no contact details.
- Pairs with get_x_following for the other direction.

## Siblings

- [`get_x_profile`](https://parel.si/docs/tools/get_x_profile.md)
- [`search_x_users`](https://parel.si/docs/tools/search_x_users.md)
