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 на каждый аккаунт.
- Отправьте {"usernames": ["elonmusk", "BBCWorld"]} методом POST на /v1/x/user-about.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте по одной строке на аккаунт из 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: если некоторых аккаунтов нет, остальные все равно возвращаются, а для отсутствующих просто нет строки.
Связанные API
Помимо 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 — Собирайте верифицированные аккаунты, подписанные на профиль: имена пользователей, имена, аватары и даты регистрации.
- Twitter Tweet 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 Follow Checker API
- Twitter Video Transcript API