x/
profiles

Превращайте одно или несколько публичных имен пользователей X в записи профилей: данные об аккаунте, описание профиля, изображения, статус аккаунта, видимые счетчики аудитории и время сбора.

Twitter Profile Scraper API

Данные профиля
Счетчики аудитории
Снимки аккаунтов
0,6 кредита за результат
Готово
Готово

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

README

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

Twitter Profile Scraper

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

Возможности Twitter Profile Scraper API

  • Профиль по имени пользователяОбрабатывает одно или несколько публичных имен пользователей X в одном сборе, независимо от того, начинается ли значение с @.
  • Данные, описание и изображенияФормирует запись аккаунта из ID, имени пользователя, отображаемого имени, URL профиля, описания профиля, местоположения, аватара, обложки и времени создания.
  • Состояние аккаунта и масштаб аудиторииСвязывает признаки верификации, приватности, личных сообщений, закрепленного поста и автоматизации с числом подписчиков, подписок, постов, медиафайлов и лайков.
  • Сопоставимые снимки профиляХранит вместе переданное имя пользователя, дату создания аккаунта и collected_at, чтобы повторные запросы оставались отслеживаемыми во времени.

Параметры Twitter Profile Scraper API

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

Как использовать Twitter Profile Scraper API

Сначала подготовьте список аккаунтов, затем обработайте его через общую асинхронную задачу и получение результатов по курсору.

  1. Приведите к единому виду публичные имена пользователей, которые нужно проверить; начальный @ необязателен.
  2. Отправьте массив usernames методом POST на /v1/x/profiles и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
  4. После успешного завершения сохраняйте data.results.items и используйте next_cursor, пока has_more остается true.
curl -X POST "https://api.socq.ai/v1/x/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","@OpenAI"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Twitter Profile Scraper API

  • Проверка аккаунтов авторов и партнеров: Сравнивайте данные об аккаунте, описание профиля, статус верификации и счетчики аудитории в известном списке, прежде чем добавлять аккаунты в шорт-лист.
  • Пополнение каталогов аккаунтов: Добавляйте URL профилей, отображаемые имена, описания, изображения, местоположения и публичные счетчики к существующим записям в CRM или о партнерах.
  • Сравнение изменений профиля: Повторяйте запросы для тех же ID аккаунтов и используйте collected_at, чтобы сравнивать описания профиля, признаки статуса и счетчики аудитории между снимками.

Практические советы по Twitter Profile Scraper API

  • Удаляйте начальный @ и убирайте дубли имен пользователей без учета регистра, прежде чем отправлять большой список аккаунтов.
  • Храните id как стабильный ключ аккаунта, сохраняя username и extra.input_username для отображения и сопоставления с источником.
  • Привязывайте каждое сравнение числа подписчиков, постов или медиафайлов к collected_at, а не считайте счетчики постоянными значениями.
  • Допускайте, что необязательные изображения и признаки аккаунта могут быть null, чтобы неполный публичный профиль не ломал последующие записи.

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

  • Twitter User Tweets 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 Media Scraper API — Собирайте посты аккаунта с фото, видео и GIF вместе с медиафайлами в максимальном качестве.

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

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

Twitter Profile Scraper API — FAQ

Twitter Profile Scraper API получает публичные записи профилей X для одного или нескольких имен пользователей. Он возвращает данные об аккаунте, описание профиля, изображения, признаки статуса, видимые счетчики аудитории и время сбора.

Передайте одно или несколько публичных имен в массиве usernames. Принимаются и nasa, и @nasa, а повторяющиеся значения нормализуются перед сбором.

Запись может содержать ID аккаунта, имя пользователя, отображаемое имя, URL профиля, описание профиля, местоположение, аватар, обложку, состояние аккаунта, время создания и публичные счетчики.

Считайте их публичными значениями, зафиксированными на момент collected_at. Если нужно сравнивать изменения во времени, сохраняйте повторные записи для одного и того же id.

Результат зависит от того, корректно ли имя пользователя и публично ли доступен аккаунт во время сбора. Переименованные, приватные, заблокированные, ограниченные или недоступные аккаунты могут не дать пригодной записи.

Каждый возвращенный нормализованный профиль стоит 0,6 кредита SocQ.