# Top 5 followers of an account ranked by Twitter Score

> **Deprecated.** This route is kept for existing clients; new integrations should use the replacement named in the description.

`GET https://twitterscore.io/api/v1/get_twitter_top_followers`

Returns the five highest-scoring accounts that follow the given profile. Only followers that TwitterScore actively monitors are considered: the follower must be an active, non-suspended monitored account and the follow relationship must still be active. Results are sorted by the follower's Twitter Score descending and hard-capped at 5 entries; there is no paging. Deprecated in the public docs in favour of the paginated follower list (get_followers / top_followers_paginate), which returns the same accounts with richer fields.

**Required:** one of `username`, `twitter_id`.
**Nested fields**

- `top_followers[].twitter_id` (integer): Follower's numeric X id. This endpoint returns it as a JSON number (PositiveBigIntegerField), unlike the paginated endpoints which return it as a string; values above 2^53 lose precision in JavaScript.
- `top_followers[].username` (string): Follower's handle without @.
- `top_followers[].name` (string): Follower's display name.
- `top_followers[].twitter_score` (number): Follower's Twitter Score on the 0–1000 scale (FloatField, so it may carry decimals).
- `top_followers[].followers_count` (integer): Follower's own current follower count.
- `top_followers[].profile_image` (string): Absolute URL of the follower's stored profile picture (S3 storage), or null when none is stored.

## Parameters

| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| `username` | string | no |  | X/Twitter handle of the account whose followers to list, without the leading @. Surrounding whitespace and a trailing slash are tolerated. Renamed handles are resolved through the previous-username history when the current handle is unknown. |
| `twitter_id` | integer | no |  | Numeric X/Twitter user id of the account. Tried first when both are sent; if no account matches the id, the lookup falls back to username. Can exceed 2^53 for newer accounts, so treat it as a 64-bit integer. |

At least one of `username`, `twitter_id` is required.

## Example request

```bash
curl -s "https://twitterscore.io/api/v1/get_twitter_top_followers?username=VitalikButerin" \
  -H "X-API-Key: $TWITTERSCORE_API_KEY" \
  -H "User-Agent: my-app/1.0 (contact@example.com)"
```

```python
import os, requests

r = requests.get(
    "https://twitterscore.io/api/v1/get_twitter_top_followers",
    params={"username": "VitalikButerin"},
    headers={"X-API-Key": os.environ["TWITTERSCORE_API_KEY"],
             "User-Agent": "my-app/1.0 (contact@example.com)"},
    timeout=15,
)
data = r.json()
if not data.get("success", True):      # errors arrive as success=false (see /developers/errors/)
    raise RuntimeError(data["message"])
print(data)
```

```javascript
const r = await fetch("https://twitterscore.io/api/v1/get_twitter_top_followers?username=VitalikButerin", {
  headers: { "X-API-Key": process.env.TWITTERSCORE_API_KEY,
             "User-Agent": "my-app/1.0 (contact@example.com)" },
});
const data = await r.json();
if (data.success === false) throw new Error(data.message);
console.log(data);
```

## Example response

```json
{
  "success": true,
  "top_followers": [
    {
      "twitter_id": 44196397,
      "username": "elonmusk",
      "name": "Elon Musk",
      "twitter_score": 998.6,
      "followers_count": 221574312,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/elonmusk.jpg"
    },
    {
      "twitter_id": 902926941413453824,
      "username": "cz_binance",
      "name": "CZ BNB",
      "twitter_score": 981.2,
      "followers_count": 10215733,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/cz_binance.jpg"
    },
    {
      "twitter_id": 14379660,
      "username": "brian_armstrong",
      "name": "Brian Armstrong",
      "twitter_score": 964.9,
      "followers_count": 1489021,
      "profile_image": null
    }
  ]
}
```

## Errors

Error codes this endpoint can return (see [Errors](/developers/errors/) for the body format): `api_key_missing`, `api_key_invalid`, `api_access_deactivated`, `api_key_revoked`, `invalid_params`, `account_not_found`, `method_not_allowed`, `rate_limited`, `quota_exceeded`, `server_error`.

---

Authentication: `X-API-Key` header (or `Authorization: Bearer`), see [Authentication](/developers/authentication/). Limits: per-minute rate and monthly quota by plan, see [Rate limits](/developers/rate-limits/). Machine-readable definition: [/openapi.json](/openapi.json).