x/
user-about

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

X Account Location API

Страна аккаунта
Способ подключения
Пакет имен пользователей
0,7 кредита за результат
Готово
Готово

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

README

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

X Account Location

Панель About this account в X — это короткая справка, привязанная к каждому профилю: страна или регион, где находится аккаунт, магазин приложений, приложение или веб-клиент, через который он подключается, дата регистрации, число смен имени пользователя и организация, с которой связан аккаунт. Вместе эти сведения позволяют проверить, действительно ли аккаунт работает оттуда, куда указывает его контент, оценивать авторов перед сделкой и находить группы аккаунтов с неожиданным общим происхождением.

Возможности X Account Location API

  • Страна, которую X указывает для аккаунтаcountry содержит значение «Account based in» из панели About this account в профиле, например United States или United Kingdom.
  • Как аккаунт подключается к Xconnected_via называет канал, который X связывает с аккаунтом, например United States App Store, Android App или Web; его можно сопоставить с country.
  • Дата регистрации и история имениpublished_at содержит дату регистрации аккаунта в X, а username_changes_count — число его переименований: два быстрых признака того, насколько устоялось имя пользователя.
  • Аффилированность и подтверждение личностиaffiliate_username показывает значок организации в профиле, например X у elonmusk или BBCNews у BBCWorld, рядом с is_identity_verified и признаком синей галочки is_verified.
  • Строка на каждое имя пользователя в одной задачеПередайте список имен пользователей (начальный @ необязателен), и каждый аккаунт вернется отдельной строкой с id, username, name, avatar_url и is_private вместе со сведениями о местоположении.

Параметры X Account Location API

ПараметрыОбязательныйОписание
usernamesОбязательныйИмена пользователей X для проверки, с начальным @ или без него. Каждый аккаунт возвращается отдельной строкой.

Как использовать X Account Location API

Отправьте имена пользователей и прочитайте по одной строке About this account на каждый аккаунт.

  1. Отправьте {"usernames": ["elonmusk", "BBCWorld"]} методом POST на /v1/x/user-about.
  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/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["elonmusk","BBCWorld"]}'

# An account that shows no country on X still returns a row, with country set to null.

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

  • Откуда работают политические и новостные аккаунты: Проверьте аккаунты, которые продвигают политическую или новостную тему, и отметьте те, чьи country или connected_via указывают на другую часть мира, чем аудитория, к которой они обращаются.
  • Проверка автора перед платным партнерством: Убедитесь, что country соответствует рынку, за охват которого вы платите, и посмотрите на published_at и username_changes_count, чтобы выявить недавно созданный или часто переименовываемый аккаунт.
  • Группировка аккаунтов, которые могут действовать согласованно: Кластеризуйте набор подозрительных аккаунтов по country, connected_via и месяцу регистрации, чтобы выявить партии аккаунтов, созданных примерно в одно время из одного места.
  • Подсчет стран, из которых идет обсуждение: Передайте имена пользователей, которые ответили на пост или сделали его репост (их можно собрать другими эндпоинтами X), и посчитайте country, чтобы увидеть, из каких регионов идет обсуждение.

Практические советы по X Account Location API

  • Прежде чем помечать аккаунт как управляемый из-за рубежа, смотрите country вместе с connected_via и published_at: одно поле само по себе может ввести в заблуждение.
  • Храните аккаунты по id: username_changes_count показывает, как часто может меняться имя пользователя.
  • Сохраняйте collected_at для каждой строки и позже повторяйте запрос для тех же имен пользователей, чтобы заметить изменения country, connected_via или username_changes_count.
  • Сопоставляйте возвращенные строки со входным списком по username: если некоторых аккаунтов нет, остальные все равно возвращаются, а для отсутствующих просто нет строки.

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

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

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

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

X Account Location API — FAQ

X Account Location API — это программный интерфейс для чтения сведений из панели About this account аккаунтов X по списку имен пользователей. Он возвращает страну или регион, где находится каждый аккаунт, способ подключения к X, дату регистрации, число смен имени пользователя, значок аффилированной организации и признаки верификации.

X показывает это как «Account based in» в панели About this account в профиле. Передайте сюда имя пользователя, и то же значение придет в country, поэтому в одной задаче можно проверить много аккаунтов.

Это описание того, откуда аккаунт подключается к X: например, через App Store определенной страны, приложение для Android или веб-версию. Эндпоинт возвращает это значение в connected_via.

Для некоторых аккаунтов X не показывает страну, в том числе для многих государственных и общественно значимых аккаунтов, например NASA. Они все равно возвращают строку с заполненными остальными полями и country, равным null.

Это значение, которое сам X показывает в панели About this account, и оно возвращается без изменений. Оно говорит, где, по мнению X, находится аккаунт, — это метка X, а не текущее местонахождение человека, стоящего за аккаунтом.

Нет. Местоположение, которое пользователи вводят в профиле произвольным текстом, — это отдельное поле; Twitter Profile Scraper API возвращает его в location.