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
Отправьте имена пользователей, выберите, сколько верифицированных подписчиков собрать для каждого, затем постранично читайте строки.
- Отправьте {"usernames": ["NASA"], "results_limit": 100} методом POST на /v1/x/verified-followers.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте верифицированных подписчиков из 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.
Связанные API
Помимо 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 — Проверяйте, подписан ли один аккаунт на другие и подписаны ли они на него в ответ.
- Twitter Tweet Scraper API
- Twitter User Tweets 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 API
- X Community Posts API
- X Thread Context 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 Video Transcript API