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

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

POST

Состояние API

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

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

X (Twitter) Following list показывает, на кого подписан один аккаунт X. Укажите имя пользователя аккаунта в username; каждая возвращённая запись будет описывать один аккаунт, на который он подписан: имя пользователя, name, url профиля, location, число его подписчиков, подписок и постов, статус верификации, признак защищённости и дату создания. Результат показывает, куда направлено внимание аккаунта: например, какие источники читает журналист, за какими партнёрами и конкурентами следит бренд или кто входит в окружение автора. Исследователи и маркетологи используют его как исходный список для поиска связанных аккаунтов и построения графов связей.

Начальный @ в имени пользователя допустим, а URL профиля — нет. Счётчики и признаки в каждой записи описывают аккаунт из подписок, поэтому сортировка по follower_count отделяет крупные аккаунты от небольших внутри списка. Записи охватывают только те подписки, которые X показывает публично, и список может быть неполным. Поэтому не считайте количество записей точным общим числом аккаунтов, на которые подписан пользователь.

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

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: twitter и action: following_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": "following_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Даfollowing_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": "following_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": "following_list",
  "results": [
    {
      "id": "•••",
      "username": "•••",
      "url": "https://x.com/•••",
      "name": "•••",
      "text": "Serving President Donald J. Trump as the 16th @NASA Deputy Administrator | Working alongside @••• to lead the next Golden Age of space discovery 🚀",
      "avatar_url": "https://pbs.twimg.com/•••",
      "follower_count": 5417,
      "following_count": 6,
      "post_count": 64,
      "is_verified": false,
      "is_protected": false,
      "created_at": "Thu May 14 18:55:50 +0000 2026",
      "platform": "twitter"
    },
    {
      "id": "•••",
      "username": "•••",
      "url": "https://x.com/•••",
      "name": "•••",
      "text": "@••• astronaut. Artemis II crewmember | Astronaute @••• Membre de l’équipage d’Artemis II",
      "location": "•••",
      "avatar_url": "https://pbs.twimg.com/•••",
      "follower_count": 149812,
      "following_count": 155,
      "post_count": 2844,
      "is_verified": false,
      "is_protected": false,
      "created_at": "Tue Aug 09 14:55:39 +0000 2011",
      "platform": "twitter"
    }
  ],
  "count": 115,
  "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) Follower list с тем же именем пользователя. Обе возможности возвращают записи с одинаковыми полями, поэтому два списка можно свести в одну таблицу со столбцом направления.

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

Сортируйте записи по follower_count, то есть по числу подписчиков каждого аккаунта в списке, и проверяйте is_verified, чтобы найти аккаунты, верифицированные платформой. Записи, в которых follower_count равен null, исключайте из ранжирования, а не считайте нулём: null означает, что X не раскрыл число.

Что означает is_protected в записи?

Значение равно true, если аккаунт из подписок защищён, то есть его посты видны только подписчикам. Сама подписка здесь всё равно отображается, но публичных постов у таких аккаунтов нет, поэтому исключите их, прежде чем собирать посты аккаунтов из списка.

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

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

Ошибки

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

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

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

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

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