Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API X (Twitter) Список подписчиков

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Изучите аудиторию аккаунта X (Twitter) через его подписчиков. Для каждого подписчика возвращаются био, местоположение, счётчики, статус верификации и признак защищённого аккаунта. Список включает только тех подписчиков, которых показывает X, и может быть неполным. Счётчики в каждой записи относятся к самому подписчику.

X (Twitter) Follower list по username возвращает список аккаунтов, подписанных на указанный аккаунт X. Каждая запись соответствует одному подписчику и содержит его имя пользователя, отображаемое имя в name, ссылку на профиль, location в исходном написании, число подписчиков, подписок и постов, данные о верификации, признак защищённого аккаунта и дату его создания. SMM-специалисты, исследователи аудитории и команды брендов используют эту возможность, чтобы понять, из кого состоит аудитория аккаунта: составить профиль подписчиков бренда или автора, найти влиятельных подписчиков, с которыми стоит взаимодействовать, или сравнить аудитории двух аккаунтов.

Передавайте имя пользователя с @ или без, но не полную ссылку на профиль. Все счётчики в записи относятся к подписчику из этой записи, а не к запрошенному аккаунту. Список содержит подписчиков, которых показывает X, и это могут быть не все подписчики, поэтому рассматривайте его как срез аудитории, а не как полную перепись. created_at помогает выявлять группы недавно созданных аккаунтов при аудите аудитории.

Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra X (Twitter) Список подписчиков (twitter/followers_list).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: twitter и action: followers_list, а параметры передайте в params.
- Обязательные параметры:
  - username: Имя пользователя X, при желании с префиксом @; полный URL профиля вводить не нужно. profile собирает данные об авторе из его недавних постов, а followers_list и following_list возвращают видимых подписчиков и видимые под…
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 2000. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 200)
- Возвращает список записей. Основные поля каждой записи: id, username, url, name, text, location, avatar_url, follower_count, following_count, post_count, is_verified, is_protected; всего полей: 13, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=twitter.
- Пример тела запроса:
{
  "platform": "twitter",
  "action": "followers_list",
  "params": {
    "username": "nasa"
  }
}
- Цена: $0.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаtwitterИдентификатор платформы, фиксированное значение.
actionbodystringДаfollowers_listИдентификатор возможности, фиксированное значение.
usernamebody.paramsstringДа-Имя пользователя X, при желании с префиксом @; полный URL профиля вводить не нужно. profile собирает данные об авторе из его недавних постов, а followers_list и following_list возвращают видимых подписчиков и видимые подписки соответственно.
limitbody.paramsinteger (1–2000)Нет200Максимальное число записей в этом вызове, целое число от 1 до 2000. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "twitter",
  "action": "followers_list",
  "params": {
    "username": "nasa"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "twitter",
  "action": "followers_list",
  "results": [
    {
      "id": "•••",
      "username": "•••",
      "url": "https://x.com/•••",
      "name": "•••",
      "text": "",
      "avatar_url": "https://pbs.twimg.com/•••",
      "follower_count": 0,
      "following_count": 6,
      "post_count": 0,
      "is_verified": false,
      "is_protected": false,
      "created_at": "Tue Aug 25 06:17:15 +0000 2026",
      "platform": "twitter"
    },
    {
      "id": "•••",
      "username": "•••",
      "url": "https://x.com/•••",
      "name": "•••",
      "text": "",
      "avatar_url": "https://abs.twimg.com/•••",
      "follower_count": 0,
      "following_count": 25,
      "post_count": 0,
      "is_verified": false,
      "is_protected": false,
      "created_at": "Sat Sep 26 10:42:56 +0000 2026",
      "platform": "twitter"
    }
  ],
  "count": 200,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
usernameИмя пользователя (@handle).
urlСсылка на запись на платформе.
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
locationОписание местоположения передаётся как есть; формат зависит от платформы.
avatar_urlСсылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь.
follower_countПодписчики. null означает, что значение не раскрыто, а не 0.
following_countПодписки. null означает, что значение не раскрыто, а не 0.
post_countВсего публикаций. null означает, что значение не раскрыто, а не 0.
is_verifiedПодтверждён ли аккаунт платформой. null означает, что это невозможно определить.
is_protectedТрактуется так же, как на самой платформе
created_atВремя создания, в том же формате, что и posted_at.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Как получить список подписчиков аккаунта X (Twitter)?

Передайте никнейм аккаунта в username, например nasa или @nasa, а не полную ссылку на профиль x.com. Каждая запись описывает одного подписчика полями username, name, url и location, а id — уникальный ID этого подписчика в X: его и стоит сохранять, чтобы сравнивать списки, полученные в разные дни.

К кому относятся значения follower_count и post_count в каждой записи?

Они относятся к подписчику из этой записи, а не к аккаунту, который вы запросили. Сортируйте по follower_count, чтобы найти в аудитории людей с наибольшим числом подписчиков, и считайте null нераскрытым значением, а не нулём. Чтобы получить показатели самого запрошенного аккаунта, вызовите возможность X (Twitter) Details с тем же никнеймом.

Как получить список аккаунтов, на которые кто-то подписан?

Используйте возможность X (Twitter) Following list. Она принимает тот же username и возвращает записи с теми же полями, по одной на каждый аккаунт в подписках. Если получить оба списка для одного аккаунта, видны его взаимные связи: никнеймы, которые есть в обоих списках.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • X: подписчики и подписки — в чём разница ↗

    X отдельно объясняет, кто подписан на вас и на кого подписаны вы, поскольку подписка не обязательно взаимна; для защищённых постов действуют дополнительные ограничения доступа. Запросы списков не выполняют массовую подписку и не расширяют права доступа.

    Проверено 2026-09-04