# Get User Followers

**API:** Data API

**Endpoint:** `GET /v1/beta/twitter/user/followers`

**Tags:** Twitter / X

List the accounts that follow a given X user, identified by @handle, newest follower first. Returns up to 200 per page by default with `has_next_page` and `next_cursor`; each entry is a full user object (handle, name, bio, follower count, verification). Use this for audience analysis, mapping a competitor's follower base, or finding influential followers. For the reverse direction (who this user follows) use `get_twitter_user_followings`. For only the verified subset use `get_twitter_user_verified_followers` — note that one takes a numeric `user_id`, not a handle.

### Pricing reference

- Metering: Metered result count.
- Reference request estimate: USD 0.00326.
- Minimum cost basis: USD 0.0006.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
- Cost bases do not establish the final customer price, including when zero.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string |  |
| `userName` | query | no | string | X username (the part after @), for example OpenAI. |

## Responses

### 200 — User followers

Headers:
- `X-Request-Id` (string) — Request identifier to include when contacting Felo support.

**application/json**

Schema: `ResponseAd3D19335Ae4_UserFollowersResponse` (`#/components/schemas/ResponseAd3D19335Ae4_UserFollowersResponse`)

### 400 — The request could not be processed. Check the request parameters.

### 401 — A valid Felo API key is required.

### 402 — The request cannot proceed because a billing requirement is not met.

### 403 — The account is not permitted to perform this operation.

### 429 — A request or spending limit has been reached.

### 502 — The service could not complete the request.

### 503 — The API or billing service is temporarily unavailable.

### 504 — The service timed out while processing the request.

### default — Error response; upstream passthrough responses may use provider formats

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseAd3D19335Ae4_UserFollowersResponse

`#/components/schemas/ResponseAd3D19335Ae4_UserFollowersResponse`

```json
{
  "type": "object",
  "properties": {
    "followers": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Public profile of an X follower."
      }
    },
    "has_next_page": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "msg": {
      "type": "string"
    },
    "code": {
      "type": "integer"
    }
  }
}
```
