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
Передайте публичные исходные имена пользователей, затем прочитайте нормализованные записи профилей в подписках из завершенной асинхронной задачи.
- Подготовьте одно или несколько публичных имен пользователей X, с начальным @ или без него, и выберите results_limit на имя пользователя — значение, кратное 200, от 200 до 2000.
- Отправьте usernames и results_limit методом POST на /v1/x/following-list и сохраните возвращенный task_id.
- Опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying, и остановитесь, когда она завершится успешно или с ошибкой.
- После успешного завершения читайте 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.
- Не считайте порядок в ответе показателем давности связи, интенсивности взаимодействия или одобрения: ответ отражает порядок сбора, а не эти сигналы.
Связанные API
Помимо 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, дату регистрации и число смен имени пользователя.
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API