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 публичных постов как асинхронную задачу, затем прочитайте нормализованные записи ответов из завершенной задачи.
- Подготовьте один или несколько публичных URL x.com или twitter.com с числовым /status/{id} и выберите порядок relevance, latest или likes.
- Отправьте urls, results_limit на пост от 20 до 2000 с шагом 20 и sort_by методом POST на /v1/x/post-replies.
- Сохраните возвращенный task_id и опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying.
- После успешного завершения читайте 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, не придумывая значения-заглушки.
Связанные API
Помимо 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 Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community 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
- Twitter Follow Checker API
- Twitter Video Transcript API