Twitter Follow Checker
Подписка в X (бывший Twitter) — это односторонняя связь от одного аккаунта к другому, поэтому любые два аккаунта находятся в одном из четырех состояний: никто ни на кого не подписан, первый подписан на второго, второй подписан на первого или оба подписаны друг на друга. Зная состояние пары, можно ответить на повседневные вопросы: подписаны ли участники конкурса на бренд, подписался ли партнер в ответ и насколько тесно связана между собой группа авторов.
Возможности Twitter Follow Checker API
- Один аккаунт против 100 другихУкажите проверяемый аккаунт в username, а до 100 аккаунтов — в usernames: каждая пара возвращается отдельной строкой с source_username и target_username.
- Оба направления и взаимность в одной строкеis_following показывает, подписан ли username на другой аккаунт, is_followed_by — подписан ли тот аккаунт в ответ, а is_mutual равно true, когда выполняются оба условия.
- Ключ пары и ссылка на профильid имеет вид source_username:target_username, а url ведет на профиль целевого аккаунта, поэтому строки легко сопоставить с вашими списками и открыть в один клик.
Параметры Twitter Follow Checker API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный | Проверяемый аккаунт X, который сравнивается с каждым аккаунтом из usernames. |
usernames | Обязательный | До 100 имен пользователей X для сравнения с username. Для каждого возвращается строка с соответствующей парой. |
Как использовать Twitter Follow Checker API
Отправьте один аккаунт и аккаунты для сравнения с ним, затем читайте по одной строке на каждую пару.
- Отправьте {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} методом POST на /v1/x/check-follow.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте каждую пару из results.items и передавайте results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/check-follow" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"elonmusk","usernames":["SpaceX","NASA"]}'
# is_following: elonmusk follows the target; is_followed_by: the target follows elonmusk back.Сценарии использования Twitter Follow Checker API
- Проверка подписки у участников розыгрыша: Укажите аккаунт бренда в username, а до 100 участников — в usernames и оставьте тех участников, у которых is_followed_by равно true.
- Поиск партнеров, которые еще не подписались в ответ: Сравните свой аккаунт с авторами или брендами, на которых вы подписаны, и выпишите пары, где is_following равно true, а is_followed_by равно false.
- Карта связей внутри группы авторов: Поочередно указывайте каждого участника в username против остальной группы и по is_mutual стройте схему того, кто с кем связан.
- Отслеживание подписок ключевого аккаунта на конкурентов: Сравните аккаунт руководителя или журналиста со списком конкурентов и повторите проверку позже, чтобы увидеть, когда меняется is_following.
Практические советы по Twitter Follow Checker API
- Списки длиннее 100 аккаунтов очистите от дублей, разбейте на пакеты по 100 и объедините результаты по id.
- Если для целевого аккаунта не вернулось строки, отмечайте его как непроверенный и храните отдельно от пар со значением false: строку дают только найденные аккаунты.
- Сохраняйте collected_at для каждой пары и позже повторяйте ту же проверку: сравнение запусков показывает новые подписки и отписки.
Связанные API
Помимо Twitter Follow Checker 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 Community API — Получайте по ссылкам на сообщества описания, число участников, правила и порядок вступления.
- X Account Location API — Узнавайте страну, в которой находится аккаунт, способ подключения к X, дату регистрации и число смен имени пользователя.
- 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 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 Video Transcript API