x/
post-retweeters

Собирайте нормализованные публичные профили аккаунтов, которые сделали репост известных постов X или Twitter, с удалением дублей на уровне задачи, видимыми признаками аккаунта и метриками профиля.

X Post Retweeters API

Аудитории репостов
Публичные профили
Удаление дублей в задаче
0,5 кредита за результат
Готово
Готово

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

README

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

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 публичных статусов как асинхронную задачу, опрашивайте ее состояние, затем постранично читайте уникальные нормализованные профили.

  1. Подготовьте один или несколько публичных URL x.com или twitter.com, путь которых содержит /status/{numeric_post_id}.
  2. Отправьте urls методом POST с results_limit от 100 до 2 000 с шагом 100.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /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, а результаты — пустыми, потому что публичные описания, изображения, признаки аккаунта, счетчики или видимость сделавших репост могут быть недоступны.

Помимо 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 — Получайте по ссылкам на сообщества описания, число участников, правила и порядок вступления.

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

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

X Post Retweeters API — FAQ

X Post Retweeters API получает нормализованные публичные записи профилей аккаунтов, замеченных в репостах одного или нескольких известных постов X или Twitter.

Передавайте URL с http или https на x.com, www.x.com, m.x.com, mobile.x.com, twitter.com, www.twitter.com, m.twitter.com или mobile.twitter.com, путь которых содержит /status/{numeric_post_id}.

Лимит применяется к каждому исходному посту независимо, по умолчанию равен 100 и должен быть кратен 100 в диапазоне от 100 до 2 000.

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

Нет. Результаты — это нормализованные записи профилей замеченных авторов репостов; они не содержат объектов репостов, добавленных комментариев или содержимого постов-цитат.

Нет. Профили очищаются от дублей в пределах задачи, и нормализованная запись не сохраняет URL или ID исходного поста. Если такая привязка нужна, передавайте один пост на задачу.

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

Итоговое списание — 0,5 кредита за каждый уникальный сохраненный профиль без базовой платы. Оценка для предоплаты использует число переданных URL и results_limit на пост, а пустой результат стоит ноль кредитов.