x/
following-list

Собирайте публичные профили X, на которые подписаны одно или несколько имен пользователей: данные об аккаунте, описания профиля, признаки аккаунта, видимые счетчики и контекст исходного аккаунта.

X Following List API

Связи по подпискам
Контекст профиля
Лимиты на аккаунт
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

X Following List

Списки подписок X — это публично видимые связи между аккаунтами, которые показывают, на какие профили подписан исходный аккаунт, с данными об аккаунте, описаниями профиля, ссылками, изображениями, статусом аккаунта, счетчиками и сведениями о создании. Эти записи помогают исследовать сети интересов, находить новые аккаунты, строить карты связей и обогащать наборы данных о профилях.

Возможности X Following List API

  • Сбор подписок нескольких аккаунтовПринимает одно или несколько публичных имен пользователей X и выполняет для каждого исходного аккаунта отдельный ограниченный сбор списка подписок.
  • Данные и контекст профиляВозвращает ID, имена пользователей, отображаемые имена, канонические URL, описания профиля, сайты, местоположения, аватары, баннеры и время создания аккаунтов, на которые оформлена подписка.
  • Признаки аккаунта и публичные счетчикиОбъединяет видимые признаки верификации, защиты, личных сообщений, закрепленного поста и автоматизации с числом подписчиков, подписок, постов, медиафайлов и лайков.
  • Нормализованные записи с учетом источникаХранит каждый сохраненный профиль в единой публичной структуре с collected_at и extra.input_username для отслеживания источника.

Параметры X Following List API

ПараметрыОбязательныйОписание
usernamesОбязательныйОбязательный массив непустых публичных имен пользователей X. Значения могут начинаться с @ или без него.
results_limitНеобязательныйМаксимальное число профилей в подписках на одно имя пользователя. По умолчанию 200, допускаются значения, кратные 200, от 200 до 2000.

Как использовать X Following List API

Передайте публичные исходные имена пользователей, затем прочитайте нормализованные записи профилей в подписках из завершенной асинхронной задачи.

  1. Подготовьте одно или несколько публичных имен пользователей X, с начальным @ или без него, и выберите results_limit на имя пользователя — значение, кратное 200, от 200 до 2000.
  2. Отправьте usernames и results_limit методом POST на /v1/x/following-list и сохраните возвращенный task_id.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying, и остановитесь, когда она завершится успешно или с ошибкой.
  4. После успешного завершения читайте data.results.items и продолжайте запрашивать задачу с next_cursor, пока data.results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@X"],"results_limit":200}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is true

Сценарии использования X Following List API

  • Исследование сетей интересов: Связывайте каждое сохраненное исходное имя пользователя с данными, описаниями, ссылками и местоположениями профилей в подписках, чтобы изучать публичные интересы вокруг известных аккаунтов.
  • Поиск аккаунтов от исходных профилей: Используйте имена, описания профиля, изображения, признаки верификации и видимые счетчики, чтобы оценивать аккаунты-кандидаты, найденные через публичный список подписок исходного профиля.
  • Обогащение списков связей: Добавляйте стабильные ID, канонические URL профилей, публичные метаданные аккаунтов, счетчики и время сбора к существующим записям связей на основе имен пользователей.

Практические советы по X Following List API

  • Удаляйте начальные символы @ и убирайте дубли исходных имен пользователей без учета регистра перед отправкой, чтобы равнозначные имена не запускали повторную обработку исходного аккаунта.
  • Задавайте results_limit на имя пользователя с шагом 200; при нескольких источниках рассчитывайте на число записей до usernames × results_limit — до того, как скажутся окончание списков и удаление дублей на уровне задачи.
  • Строя граф «многие ко многим», не рассчитывайте на одну сохраненную строку для каждой пары «источник — профиль»: повторяющийся профиль в подписках может быть объединен и сохранить только одно значение extra.input_username.
  • Считайте пустой или короткий список следствием публичной видимости и допускайте, что необязательные изображения, признаки статуса и счетчики в последующих записях могут быть null.
  • Не считайте порядок в ответе показателем давности связи, интенсивности взаимодействия или одобрения: ответ отражает порядок сбора, а не эти сигналы.

Помимо X Following List API, используйте эти API, когда нужен другой тип публичных данных X.

  • Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • X Followers List API — Собирайте данные публичных аккаунтов подписчиков и видимые метрики профиля для одного или нескольких имен пользователей X.
  • X Post Retweeters API — Собирайте уникальный в рамках задачи набор нормализованных публичных профилей аккаунтов, сделавших репост известных URL статусов X или Twitter.
  • X Community API — Получайте по ссылкам на сообщества описания, число участников, правила и порядок вступления.
  • X Account Location API — Узнавайте страну, в которой находится аккаунт, способ подключения к X, дату регистрации и число смен имени пользователя.

Другие платформы

Объединяйте данные X с публичными данными других поддерживаемых соцсетей.

X Following List API — FAQ

X Following List API — это программный интерфейс для сбора публичных профилей, на которые подписаны одно или несколько имен пользователей X. Он возвращает нормализованные данные об аккаунте, описания профиля, ссылки, изображения, признаки аккаунта, видимые счетчики, метки времени и контекст источника.

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

results_limit по умолчанию равен 200, принимает значения, кратные 200, до 2000 и применяется к каждому исходному имени пользователя отдельно. Видимый список может закончиться раньше запрошенного лимита.

Запись может содержать ID профиля, имя пользователя, отображаемое имя, канонический URL, описание профиля, сайт, местоположение, аватар, баннер, признаки верификации и защиты, публичные счетчики, время создания аккаунта, время сбора и extra.input_username.

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

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

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

Каждая сохраненная нормализованная запись профиля стоит 0,5 кредита. Оплата считается по фактическому числу сохраненных записей, поэтому за пустой результат плата за единицы результата не взимается.