X User Replies
Вкладка «Ответы» в профиле X (Twitter) содержит ответы аккаунта на чужие твиты, от новых к старым, и каждый из них привязан к беседе и к посту, на который он отвечает, вместе с автором и текстом этого поста. Если смотреть на ответы рядом с исходными постами, видно, с кем общается аккаунт, что он говорит за пределами основной ленты и как реагирует на вопросы и критику.
Возможности X User Replies API
- Ответы одного аккаунтаОтправьте имя пользователя, начальный @ необязателен, и получите ответы, которые опубликовал этот аккаунт, со вкладки «Ответы» в порядке от новых к старым.
- Исходный пост в той же строкеin_reply_to содержит id, url, text, author и published_at поста, на который отвечает каждый ответ, поэтому любой обмен репликами можно прочитать прямо из результата.
- ID беседы и родительского постаconversation_id и in_reply_to_id привязывают каждый ответ к его ветке и к конкретному посту над ним, что позволяет группировать ответы по беседам.
- Текст ответа, медиа и вовлеченностьКаждый ответ приходит с текстом, прикрепленными изображениями или видео, если они есть, и счетчиками лайков, комментариев, репостов и просмотров.
Параметры X User Replies API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный | Имя пользователя X, чьи ответы нужно собрать, с начальным @ или без него. |
results_limit | Необязательный | Сколько ответов вернуть: от 1 до 1 000. По умолчанию 20. |
Как использовать X User Replies API
Отправьте одно имя пользователя и читайте его ответы вместе с постами, на которые они даны.
- Отправьте {"username": "elonmusk", "results_limit": 20} методом POST на /v1/x/user-replies.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не сменится на succeeded.
- Читайте ответы из results.items, где исходный пост находится в in_reply_to, и передавайте results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"elonmusk","results_limit":20}'
# in_reply_to holds the post each reply answers: its text, author, url and publish time.Сценарии использования X User Replies API
- Карта собеседников аккаунта: Подсчитайте in_reply_to.author.username по всем ответам аккаунта, чтобы составить список людей и брендов, с которыми он взаимодействует чаще всего.
- Аудит ответов службы поддержки бренда: Читайте text каждого ответа рядом с in_reply_to.text и вычитайте in_reply_to.published_at из published_at, чтобы оценить, как быстро и насколько качественно отвечает аккаунт поддержки.
- Отслеживание высказываний публичных лиц в ответах: Собирайте ответы руководителя компании или политика по расписанию, чтобы фиксировать заявления, сделанные внутри бесед, и сохраняйте url как ссылку на источник.
- Пары «пост — ответ» для анализа: Сопоставляйте in_reply_to.text с text, чтобы собирать датасеты обменов репликами для изучения тона, позиции или тематики ответов аккаунта.
Практические советы по X User Replies API
- Удаляйте начальные @handle из text перед оценкой тональности или длины: ответ начинается с handle аккаунта, которому он адресован.
- Группируйте ответы по conversation_id, чтобы увидеть все сообщения аккаунта в одной ветке.
- Если in_reply_to.text или автор пусты, всё равно сохраняйте ответ вместе с in_reply_to.url, чтобы позже найти исходный пост.
- Используйте X Post Replies API с URL постов, если нужны ответы других людей на посты аккаунта; X User Replies API охватывает ответы, которые написал сам аккаунт.
Связанные API
Помимо X User 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 Replies API — Собирайте публичные ответы по URL постов X с выбором порядка: текст ответа, авторы, видимая вовлеченность, медиа и контекст родительского поста.
- X Thread Context API — Получайте пост вместе с предыдущими сообщениями в цепочке ответов, публичными ответами и ID связей.
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts 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