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

# get_x_following

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

## What it does

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

Use it to see whom a founder, a journalist or a brand pays attention to; [`get_x_followers`](https://parel.si/docs/tools/get_x_followers.md) is the other direction, [`get_x_profile`](https://parel.si/docs/tools/get_x_profile.md) the counts. 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_following"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_x_following"` |
| 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_following","input":{"screen_name":"Flipkart"}}'
```

## What comes back

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

```json
{
  "following": [
    {
      "user_id": "89443197",
      "screen_name": "myntra",
      "description": "Festive looks to winter layers ✨\nAll your favourite styles, in one place. Shop now 👇",
      "profile_image": "(picture link removed)",
      "statuses_count": 616187,
      "followers_count": 738152,
      "friends_count": 38,
      "website": "http://myntra.onelink.me/eWcy/2334db6l",
      "media_count": 9143,
      "name": "Myntra",
      "created_at": "Thu Nov 12 13:16:01 +0000 2009"
    },
    {
      "user_id": "1806254980787261440",
      "screen_name": "Flipkartminutes",
      "description": "order, order 👨🏻‍⚖️",
      "profile_image": "(picture link removed)",
      "statuses_count": 479,
      "followers_count": 4687,
      "friends_count": 1,
      "website": "https://www.flipkart.com/flipkart-minutes-store?marketplace=HYPERLOCAL",
      "media_count": 156,
      "name": "Flipkart Minutes",
      "created_at": "Thu Jun 27 09:15:38 +0000 2024"
    },
    {
      "user_id": "17216088",
      "screen_name": "Cleartrip",
      "description": "So, where to?",
      "profile_image": "(picture link removed)",
      "statuses_count": 235986,
      "followers_count": 34097,
      "friends_count": 0,
      "website": "https://cleartrip.app.link/BrkIGkVG7Sb",
      "media_count": 936,
      "name": "Cleartrip",
      "created_at": "Thu Nov 06 18:27:51 +0000 2008"
    }
  ],
  "status": "ok",
  "more_users": false
}
```

## Notes

- Flat per page; pass cursor for the next page. A protected or unknown account is free.
- Public accounts only.
- Pairs with get_x_followers.

## Siblings

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