Twitter Profile Scraper
Профиль X идентифицирует публичный аккаунт по имени пользователя, отображаемому имени, описанию профиля, URL профиля, изображениям, индикаторам статуса и видимым счетчикам. Если рассматривать эти сигналы вместе на известный момент сбора, они помогают оценивать аккаунты, пополнять каталоги и сравнивать изменения профилей.
Возможности Twitter Profile Scraper API
- Профиль по имени пользователяОбрабатывает одно или несколько публичных имен пользователей X в одном сборе, независимо от того, начинается ли значение с @.
- Данные, описание и изображенияФормирует запись аккаунта из ID, имени пользователя, отображаемого имени, URL профиля, описания профиля, местоположения, аватара, обложки и времени создания.
- Состояние аккаунта и масштаб аудиторииСвязывает признаки верификации, приватности, личных сообщений, закрепленного поста и автоматизации с числом подписчиков, подписок, постов, медиафайлов и лайков.
- Сопоставимые снимки профиляХранит вместе переданное имя пользователя, дату создания аккаунта и collected_at, чтобы повторные запросы оставались отслеживаемыми во времени.
Параметры Twitter Profile Scraper API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Обязательный список публичных имен пользователей X. Каждое значение может начинаться с @ или без него. |
Как использовать Twitter Profile Scraper API
Сначала подготовьте список аккаунтов, затем обработайте его через общую асинхронную задачу и получение результатов по курсору.
- Приведите к единому виду публичные имена пользователей, которые нужно проверить; начальный @ необязателен.
- Отправьте массив usernames методом POST на /v1/x/profiles и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не перейдет в статус succeeded или failed.
- После успешного завершения сохраняйте 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, чтобы неполный публичный профиль не ломал последующие записи.
Связанные API
Помимо 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 вместе с медиафайлами в максимальном качестве.
- 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 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
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API