X Post Retweeters
Записи X Post Retweeters определяют публичные аккаунты, замеченные в репостах известных URL статусов X или Twitter, и нормализуют данные их профиля, публичные признаки аккаунта, видимые счетчики и время сбора. Несколько исходных постов обходятся независимо, затем сохраненные профили очищаются от дублей в пределах задачи, а привязка к исходному посту в отдельных результатах не сохраняется.
Возможности X Post Retweeters API
- Разбор URL статусовПринимает URL публичных статусов на x.com и twitter.com и определяет числовой идентификатор поста, нужный для сбора видимого списка сделавших репост.
- Нормализованные профили аккаунтовВозвращает ID профиля, имя пользователя, отображаемое имя, канонический URL профиля, описание профиля, аватар, обложку и публичные признаки аккаунта, если они доступны.
- Видимые метрики профиляФиксирует доступное число подписчиков, подписок, постов, медиафайлов и лайков вместе с метками времени создания аккаунта и сбора.
- Уникальный набор результатов по нескольким постамОбходит каждый переданный пост с собственным лимитом результатов, а затем сохраняет каждый нормализованный профиль в завершенной задаче только один раз.
Параметры X Post Retweeters API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательные URL публичных статусов на x.com или twitter.com с числовым ID поста; несколько значений разделяйте запятыми или переносами строк. |
results_limit | Необязательный | Максимальное число профилей, запрашиваемое независимо для каждого исходного поста; по умолчанию 100, допускаются значения, кратные 100, от 100 до 2 000. |
Как использовать X Post Retweeters API
Отправьте известные URL публичных статусов как асинхронную задачу, опрашивайте ее состояние, затем постранично читайте уникальные нормализованные профили.
- Подготовьте один или несколько публичных URL x.com или twitter.com, путь которых содержит /status/{numeric_post_id}.
- Отправьте urls методом POST с results_limit от 100 до 2 000 с шагом 100.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /v1/tasks/{task_id}?limit=50 и передавайте results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/post-retweeters" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursorСценарии использования X Post Retweeters API
- Поиск аудитории, усиливающей посты: Составляйте уникальный каталог публичных аккаунтов, замеченных в распространении выбранных постов, для исследований, проверки или подготовки к аутричу.
- Обогащение профилей сделавших репост: Добавляйте канонические профили, описания, изображения, публичные признаки аккаунта, местоположения, сайты и видимые метрики в датасет о распространении.
- Пересечение аудиторий разных постов: Запускайте по одному исходному посту на задачу и сравнивайте стабильные ID профилей в завершенных наборах результатов, когда важны пересечение по постам или привязка к ним.
Практические советы по X Post Retweeters API
- Приводите URL статусов к каноническому виду и убирайте дубли по числовому ID поста перед формированием пакета, потому что разные формы URL одного поста не обязательно объединяются при проверке входных данных.
- Считайте results_limit верхним пределом на исходный пост, а не гарантированным числом результатов: из-за публичной видимости и доступной пагинации профилей может быть меньше.
- Используйте один исходный URL на задачу, если важна привязка к источнику, потому что нормализованные профили не сохраняют URL или ID исходного поста.
- Переходите по непрозрачному results.next_cursor задачи независимо от пагинации сбора: публичный курсор листает уже сохраненные нормализованные результаты.
- Используйте ID профиля как надежный ключ объединения между задачами и привязывайте меняющиеся публичные счетчики к collected_at.
- Допускайте, что поля профиля могут быть null, а результаты — пустыми, потому что публичные описания, изображения, признаки аккаунта, счетчики или видимость сделавших репост могут быть недоступны.
Связанные API
Помимо X Post Retweeters API, используйте эти API, когда нужен другой тип публичных данных X.
- Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
- Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
- X Followers List API — Собирайте данные публичных аккаунтов подписчиков и видимые метрики профиля для одного или нескольких имен пользователей X.
- X Following List API — Собирайте профили, на которые подписаны публичные аккаунты X: данные аккаунта, описания, признаки аккаунта, видимые счетчики и исходные имена пользователей.
- X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
- X Community API — Получайте по ссылкам на сообщества описания, число участников, правила и порядок вступления.
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Account Location 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
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API