x/
post-replies

Собирайте публичные ответы по одному или нескольким URL постов X: текст ответов, авторы, видимая вовлеченность, медиафайлы и родительский контекст с лимитами и сортировкой для каждого поста.

X Post Replies API

Беседы вокруг постов
Порядок ответов
Родительский контекст
0,5 кредита за результат
Готово
Готово

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

README

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

X Post Replies

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

Возможности X Post Replies API

  • Беседы известных постовПринимает один или несколько URL публичных статусов X, извлекает числовой ID каждого поста и возвращает ответы, исключая сам переданный родительский пост.
  • Записи ответов и авторовВозвращает ID ответов, канонические URL, текст, язык, время публикации и нормализованные публичные данные автора для каждого сохраненного ответа.
  • Видимые сигналы реакцииХранит вместе публичное число лайков, ответов, репостов, цитат, просмотров и закладок, а также медиафайлы, хештеги и упоминания.
  • Выбор порядка лентыЗапрашивайте порядок relevance, latest или likes для каждого переданного поста, применяя к каждой беседе отдельный лимит результатов.
  • Прослеживаемость беседыСохраняет в нормализованном контексте переданный URL, ID родительского поста, ID беседы, адресата ответа, источник, а также признаки цитаты, репоста и ограниченных ответов.

Параметры X Post Replies API

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный массив URL публичных постов на x.com или twitter.com. Каждый путь должен содержать /status/{numeric_id}; варианты домена с www, m и mobile принимаются.
results_limitНеобязательныйМаксимальное число ответов на один родительский пост. По умолчанию 100, допускаются значения, кратные 20, от 20 до 2000.
sort_byНеобязательныйПорядок ленты ответов, применяемый к каждому переданному посту: relevance, latest или likes. По умолчанию relevance.

Как использовать X Post Replies API

Отправьте известные URL публичных постов как асинхронную задачу, затем прочитайте нормализованные записи ответов из завершенной задачи.

  1. Подготовьте один или несколько публичных URL x.com или twitter.com с числовым /status/{id} и выберите порядок relevance, latest или likes.
  2. Отправьте urls, results_limit на пост от 20 до 2000 с шагом 20 и sort_by методом POST на /v1/x/post-replies.
  3. Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying.
  4. После успешного завершения читайте data.results.items и запрашивайте ту же задачу с cursor=data.results.next_cursor, пока data.results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/post-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/OpenAI/status/1950240351547248941"],"results_limit":100,"sort_by":"relevance"}'

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

Сценарии использования X Post Replies API

  • Анализ публичной реакции: Сравнивайте текст ответов, язык, авторов и видимую вовлеченность у выбранных родительских постов, чтобы изучать различия публичных бесед.
  • Восстановление веток беседы: Используйте parent_post_id, conversation_id, поля in_reply_to, ID ответов и канонические URL, чтобы заново связать сохраненные ответы с видимым контекстом ветки.
  • Мониторинг ответов между запусками: Отслеживайте время публикации ответов, collected_at, авторов и публичные счетчики для стабильного набора URL постов в плановых снимках.
  • Подготовка датасета для ручного разбора: Объединяйте текст ответов, данные об авторах, метки времени, URL и видимую вовлеченность, чтобы готовить записи ответов для последующих очередей проверки.

Практические советы по X Post Replies API

  • Перед отправкой проверяйте каждый URL на допустимый домен X или Twitter и числовой ID после /status/, чтобы ссылки на профили и поиск не приводили к неудачным задачам.
  • Извлекайте числовой ID статуса и убирайте дубли среди вариантов URL x.com и twitter.com, потому что разные строки URL могут указывать на один родительский пост.
  • Задавайте results_limit на родительский пост с шагом 20; общее число кандидатов может приближаться к urls × results_limit — до того, как скажутся окончание бесед и удаление дублей на уровне задачи.
  • Выбирайте sort_by под цель сбора, но не сравнивайте позиции в режимах relevance, latest и likes как единый рейтинг.
  • При восстановлении многих родительских бесед учитывайте удаление дублей ответов на уровне задачи: сохраненный ответ хранит только один переданный URL и контекст одного родительского поста.
  • Считайте короткий или пустой результат следствием публичной видимости и храните поля автора, медиа, метрик и связей, которые могут быть null, не придумывая значения-заглушки.

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

  • Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
  • Twitter Profile Scraper API — Получайте по имени пользователя публичные данные аккаунта, описание, аватар, обложку, статус аккаунта и видимую статистику аудитории.
  • Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
  • Twitter Search API — Находите публичные посты по поисковому выражению с сортировкой по новизне или популярности и настраиваемым лимитом результатов.
  • X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
  • X User Replies API — Собирайте ответы, которые написал аккаунт, — каждый вместе с постом, на который он отвечает.

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

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

X Post Replies API — FAQ

X Post Replies API — это программный интерфейс для сбора публичных ответов по одному или нескольким URL постов X с числовыми ID статусов. Он возвращает текст ответов, авторов, видимую вовлеченность, медиафайлы, метки времени и контекст родительской беседы.

Передайте непустой массив urls со ссылками на публичные посты x.com или twitter.com, в пути которых есть /status/{numeric_id}. Принимаются стандартный домен и варианты с www, m и mobile.

results_limit по умолчанию равен 100, принимает значения, кратные 20, от 20 до 2000 и применяется к каждому родительскому посту отдельно. Беседа может закончиться раньше запрошенного лимита.

sort_by выбирает соответствующий режим публичной ленты ответов для каждого переданного поста; по умолчанию используется relevance. Считайте возвращенный порядок результатом выбранного режима сбора, а не отдельным рейтингом SocQ.

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

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

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

Нет. Он возвращает посты-ответы в выбранных беседах; посты-цитаты и профили, сделавшие репост поста, — это отдельные ресурсы X.

Каждый сохраненный нормализованный ответ стоит 0,5 кредита. Оплата считается по фактическому числу сохраненных записей, поэтому за пустой результат плата за единицы результата не взимается.