X Thread Context
Тред на платформе X связывает пост с сообщением, на которое он отвечает, с более ранними сообщениями в этой цепочке ответов и с последующими ответами, а не просто объединяет посты, опубликованные примерно в одно время. Если сохранить эти связи вместе с текстом постов и данными авторов, читателю проще проследить, как развивалось обсуждение, и понять контекст отдельного сообщения.
Возможности X Thread Context API
- Выбранный пост вместе с окружающим обсуждениемПо ссылке на пост собирает целевое сообщение вместе с более ранними публичными сообщениями в его цепочке ответов и доступными последующими ответами, давая контекст шире одного выбранного сообщения.
- Какие посты связаны между собой и кто кому отвечаетПомимо текста, авторов и счетчиков взаимодействий, conversation_id указывает беседу, к которой относится пост, а in_reply_to_id — пост, на который он отвечает напрямую, что дает связи между отдельными записями.
Параметры X Thread Context API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список ссылок на публичные посты X, содержащих /status/ и числовой ID поста, например https://x.com/BaganiTohid/status/2110635249889919362; в песочнице указывайте по одной ссылке на строку или используйте JSON-массив urls, а не ссылки на профили или сообщества. |
results_limit | Необязательный | Необязательное максимальное число записей контекста для каждого входного поста, от 1 до 2000, по умолчанию 100; две ссылки на посты с лимитом 20 запрашивают до 20 связанных записей каждая, а не делят общий лимит 20. |
Как использовать X Thread Context API
Запрос запускает фоновую задачу сбора, поэтому первый ответ содержит ID задачи, а не готовые данные; по этому ID проверяйте ход выполнения и получайте результаты.
- Скопируйте ссылку на публичный пост, контекст которого нужно понять, и выберите, сколько записей контекста запросить для него; если ссылок несколько, поместите каждую в список urls.
- Перед запуском примера замените $SOCQ_API_KEY своим API-ключом или задайте эту переменную окружения. Отправьте JSON с входными данными на POST /v1/x/thread-context с заголовком Authorization, как показано ниже, и сохраните task_id из ответа.
- Проверяйте ход выполнения через GET /v1/tasks/{task_id} с сохраненным ID. queued означает ожидание, running — сбор идет, retrying — выполняется повторная попытка. Дождитесь succeeded, прежде чем читать результаты; если задача в статусе failed, причину смотрите в error_message.
- Когда задача завершится успешно, читайте data.results.items: каждый элемент списка описывает один пост и его доступные связи в беседе. Пустой список означает, что задача завершилась, не вернув ни одной записи.
- Если data.results.has_more равно true, значение next_cursor — это метка следующей страницы сохраненных результатов. Скопируйте его без изменений в параметр cursor запроса GET /v1/tasks/{task_id}?cursor=... и продолжайте, пока has_more не станет false.
curl -X POST "https://api.socq.ai/v1/x/thread-context" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/BaganiTohid/status/2110635249889919362"],"results_limit":20}'Сценарии использования X Thread Context API
- Проверка сообщения с нужным для чтения контекстом: Размещайте целевой пост рядом с возвращенными более ранними сообщениями и ответами, включая их текст и авторов, чтобы подготовить удобное представление для того, кто проверяет, на что отвечало выбранное сообщение.
- Карта возвращенных связей между ответами: Группируйте посты по conversation_id и сопоставляйте каждый in_reply_to_id с id другой записи, чтобы отрисовать имеющиеся связи ответов и оставить видимыми пробелы, если пост, на который есть ссылка, не вернулся.
- Исходные материалы для резюме беседы: Сохраняйте текст постов, имена авторов, время и связи ответов как упорядоченный набор для чтения, который затем резюмирует человек или отдельная программа, а не ожидайте готового резюме в ответе.
Практические советы по X Thread Context API
- Выстраивая обсуждение для чтения, сначала соединяйте посты по ID связей, а время публикации используйте лишь как вспомогательный контекст: список, отсортированный только по времени, не показывает, на какое сообщение отвечает каждый пост.
- Если in_reply_to_id ссылается на ID, которого нет в сохраненных записях, сохраните эту ссылку как недостающее звено, а не прикрепляйте ответ к другому посту и не додумывайте отсутствующий текст.
- Если несколько отправленных ссылок относятся к одной беседе, объединяйте сохраненные результаты по ID поста, чтобы общий ранний пост не повторялся в наборе для чтения несколько раз.
- Если нужны только ответы на выбранный пост, используйте X Post Replies; если нужен только сам выбранный пост, используйте X Posts вместо сбора окружающего контекста.
Связанные API
Помимо X Thread Context API, используйте эти API, когда нужен другой тип публичных данных X.
- Twitter Tweet Scraper API — Получайте по URL статусов x.com или twitter.com текст публичных постов, авторов, вовлеченность, медиа, хештеги, упоминания и связи в обсуждении.
- Twitter User Tweets Scraper API — Собирайте свежие публичные посты, авторов, медиа, хештеги, упоминания и вовлеченность по имени пользователя без ответов.
- X Post Quotes API — Собирайте публичные цитаты известных URL статусов: комментарий, авторы, вовлеченность, медиа, метки времени и контекст исходного поста.
- X Post Replies API — Собирайте публичные ответы по URL постов X с выбором порядка: текст ответа, авторы, видимая вовлеченность, медиа и контекст родительского поста.
- Twitter Mentions API — Собирайте публичные посты с упоминанием заданного аккаунта.
- X Community Posts API — Получайте публичные посты сообщества: текст, авторы и счетчики взаимодействий.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community 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