x/
verified-followers

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

X Verified Followers API

Вкладка «Верифицированные подписчики»
До 2 000 на аккаунт
Даты регистрации подписчиков
0,7 кредита за результат
Готово
Готово

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

README

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

X Verified Followers

Верифицированные подписчики X — это часть аудитории аккаунта с галочкой верификации, которая отображается на отдельной вкладке профиля «Верифицированные подписчики», где у каждого подписчика указаны handle, отображаемое имя, аватар и дата регистрации в X. Поскольку этот список заполняют авторы контента, бренды и платные пользователи, он показывает, какие авторитетные аккаунты уже следят за профилем, и дает компактную выборку для аутрича, анализа конкурентов и проверки качества аудитории.

Возможности X Verified Followers API

  • Подписчики с вкладки «Верифицированные подписчики»Строки берутся из того же списка, который X показывает на вкладке профиля «Верифицированные подписчики», поэтому у каждого возвращенного подписчика is_verified равно true.
  • Оба аккаунта в каждой строкеactor — это аккаунт, о котором вы спрашивали, related_actor — верифицированный подписчик, а relationship имеет значение follower, поэтому строки нескольких имен пользователей не смешиваются в одном наборе результатов.
  • Данные подписчика и ссылка на профильrelated_actor содержит id, username, отображаемое имя, url профиля и avatar_url каждого подписчика — этого достаточно, чтобы открыть, проверить или экспортировать аккаунт.
  • Когда подписчик зарегистрировался в Xpublished_at в каждой строке — это дата регистрации аккаунта верифицированного подписчика, что позволяет отличить давние аккаунты от недавно созданных.
  • Глубина от 20 до 2 000 на имя пользователяresults_limit применяется к каждому имени пользователя с шагом 20: от быстрой выборки из 20 аккаунтов до 2 000 верифицированных подписчиков.

Параметры X Verified Followers API

ПараметрыОбязательныйОписание
usernamesОбязательныйИмена пользователей X, чьих верифицированных подписчиков нужно собрать. Каждый аккаунт собирается отдельно.
results_limitНеобязательныйСколько верифицированных подписчиков вернуть для каждого имени пользователя: значение, кратное 20, от 20 до 2 000. По умолчанию 100.

Как использовать X Verified Followers API

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

  1. Отправьте {"usernames": ["NASA"], "results_limit": 100} методом POST на /v1/x/verified-followers.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте верифицированных подписчиков из results.items и передавайте results.next_cursor обратно, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["NASA"],"results_limit":100}'

# related_actor is the verified follower; actor is the account you asked about.

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

  • Список для аутрича из верифицированной аудитории конкурента: Соберите верифицированных подписчиков конкурента и экспортируйте related_actor.username и url, чтобы связаться с авторами, брендами и подписчиками, которые уже следят за вашей нишей.
  • Верифицированные аккаунты, подписанные только на конкурента: Соберите верифицированных подписчиков своего аккаунта и аккаунта конкурента в одной задаче, затем оставьте значения related_actor.id, которые встречаются только в списке конкурента.
  • Сравнение верифицированной аудитории нескольких профилей: Отправьте набор имен пользователей вместе и сравните число строк и общие значения related_actor.id, чтобы увидеть, какие профили привлекают одни и те же верифицированные аккаунты.
  • Выявление волны новых верифицированных подписчиков: Отсортируйте верифицированных подписчиков профиля по published_at, чтобы понять, состоит ли его аудитория с галочками в основном из давних аккаунтов или из недавно зарегистрированных в X.

Практические советы по X Verified Followers API

  • Начните с results_limit, равного 20, чтобы убедиться, что у профиля есть верифицированная аудитория, которую стоит собирать, затем увеличьте лимит; каждый возвращенный подписчик стоит 0,7 кредита.
  • Если имя пользователя возвращает ровно results_limit строк, верифицированный список может быть длиннее, поэтому для более полной картины увеличьте лимит вплоть до 2 000.
  • Используйте related_actor.id как ключ подписчика и сравнивайте запуски по collected_at, чтобы увидеть, какие верифицированные аккаунты появились с момента последней проверки.
  • Аккаунт, о котором вы спрашивали, берите из actor.username; остальные поля actor могут быть пустыми, а данные подписчика содержатся в related_actor.

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

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

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

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

X Verified Followers API — FAQ

X Verified Followers API — это программный интерфейс для сбора подписчиков с галочкой верификации у аккаунтов X по их именам пользователей, до 2 000 на аккаунт. Каждая строка связывает запрошенный аккаунт с одним верифицированным подписчиком и содержит его id, username, имя, URL профиля, аватар и дату регистрации.

В X они перечислены на вкладке «Верифицированные подписчики» в списке подписчиков профиля. Отправьте это имя пользователя сюда, чтобы получить тот же список в виде строк, которые можно сортировать, фильтровать и экспортировать.

Любой подписчик с галочкой верификации в X, то есть аккаунты, которые X показывает на вкладке «Верифицированные подписчики». У каждого возвращенного подписчика related_actor.is_verified равно true.

Да, подсчитав строки, возвращенные для этого имени пользователя. Для максимального охвата задайте results_limit равным 2 000; аккаунт с более длинным верифицированным списком вернет 2 000 строк, поэтому считайте это число минимумом.

Нет. Строки содержат id, username, имя, URL профиля, аватар, признак верификации и дату регистрации подписчика. Передайте эти имена пользователей в Twitter Profile Scraper API, если вам нужны число подписчиков или описания профилей.

Нет. Здесь published_at — это дата регистрации верифицированного подписчика в X; дата самой подписки в результат не входит.