# Получить подписчиков пользователя

**API:** Data API

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

**Tags:** Twitter / X

Перечисляет аккаунты, подписанные на указанного пользователя X, определяемого по @handle, начиная с самых новых подписчиков. По умолчанию возвращает до 200 на страницу с `has_next_page` и `next_cursor`; каждая запись — полный объект пользователя (имя пользователя, имя, био, число подписчиков, верификация). Используйте для анализа аудитории, сопоставления базы подписчиков конкурента или поиска влиятельных подписчиков. Для обратного направления (на кого подписан этот пользователь) используйте `get_twitter_user_followings`. Только для верифицированного подмножества используйте `get_twitter_user_verified_followers` — учтите, что он принимает числовой `user_id`, а не handle.

### Справочная информация о ценах

- Тарификация: тарифицируемое количество результатов.
- Справочная оценка запроса: USD 0.00326.
- Минимальная базовая стоимость: USD 0.0006.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
- Базовые стоимости не определяют итоговую цену для клиента, в том числе когда они равны нулю.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

## 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 — Подписчики пользователя

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

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

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**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": "Объект пользователя-подписчика, возвращаемый X."
      }
    },
    "has_next_page": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "msg": {
      "type": "string"
    },
    "code": {
      "type": "integer"
    }
  }
}
```