x/
check-follow

Проверяйте, подписан ли один аккаунт X на другие аккаунты (до 100) и подписаны ли они на него в ответ: для каждой пары имен пользователей возвращаются is_following, is_followed_by и is_mutual.

Twitter Follow Checker API

Подписки в обе стороны
До 100 пар в задаче
Признак взаимности
0,7 кредита за результат
Готово
Готово

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

README

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

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

Отправьте один аккаунт и аккаунты для сравнения с ним, затем читайте по одной строке на каждую пару.

  1. Отправьте {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} методом POST на /v1/x/check-follow.
  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/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 для каждой пары и позже повторяйте ту же проверку: сравнение запусков показывает новые подписки и отписки.

Помимо 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, дату регистрации и число смен имени пользователя.

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

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

Twitter Follow Checker API — FAQ

Twitter Follow Checker API — это программный интерфейс для проверки подписок между одним аккаунтом X и не более чем 100 другими только по именам пользователей. Для каждой пары он возвращает, подписан ли первый аккаунт на второй, подписан ли второй на него в ответ и является ли подписка взаимной.

Укажите первый аккаунт в username, а второй — в usernames. is_following показывает, подписан ли первый на второй, а is_followed_by в той же строке отвечает на обратный вопрос.

Укажите свое имя пользователя в username, а имя другого человека — в usernames. Значение true в is_followed_by означает, что он подписан на вас; одна задача охватывает до 100 аккаунтов.

Смотрите is_mutual. Это поле равно true, только когда каждый аккаунт подписан на другой.

Один аккаунт в username против не более чем 100 в usernames, по одной строке на пару. Более длинные списки распределяйте по нескольким задачам.

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

Не с этим эндпоинтом: он сообщает только о переданных вами парах. Для полных списков используйте X Following List API или X Followers List API.