x/
thread-context

Получайте контекст вокруг поста X по его ссылке: целевой пост, более ранние посты, на которые он отвечает, и публичные ответы возвращаются вместе с ID связей.

X Thread Context API

Пост и его контекст
Какой пост на какой отвечает
Группировка по беседам
0,5 кредита за результат
Готово
Готово

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

README

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

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 проверяйте ход выполнения и получайте результаты.

  1. Скопируйте ссылку на публичный пост, контекст которого нужно понять, и выберите, сколько записей контекста запросить для него; если ссылок несколько, поместите каждую в список urls.
  2. Перед запуском примера замените $SOCQ_API_KEY своим API-ключом или задайте эту переменную окружения. Отправьте JSON с входными данными на POST /v1/x/thread-context с заголовком Authorization, как показано ниже, и сохраните task_id из ответа.
  3. Проверяйте ход выполнения через GET /v1/tasks/{task_id} с сохраненным ID. queued означает ожидание, running — сбор идет, retrying — выполняется повторная попытка. Дождитесь succeeded, прежде чем читать результаты; если задача в статусе failed, причину смотрите в error_message.
  4. Когда задача завершится успешно, читайте data.results.items: каждый элемент списка описывает один пост и его доступные связи в беседе. Пустой список означает, что задача завершилась, не вернув ни одной записи.
  5. Если 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 вместо сбора окружающего контекста.

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

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

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

X Thread Context API — FAQ

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

Целевой пост — это пост, ссылку на который вы отправляете. Более ранние посты, которые иногда называют предками, — это сообщения, до которых можно дойти, следуя по связям ответов целевого поста назад, а не все посты, опубликованные до него.

Если A публикует пост, а B отвечает на него, поле in_reply_to_id у B содержит ID поста A. conversation_id объединяет посты в одну беседу, а in_reply_to_id указывает прямую связь ответа; если C отвечает B, то C указывает на B, а не напрямую на A.

Thread Context включает выбранный пост и публичные более ранние посты в его цепочке ответов, а также ответы. X Post Replies сосредоточен на ответах на переданный пост, поэтому подходит для более узкой задачи сбора ответов.

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

Нет. Курсор читает следующую страницу записей, уже сохраненных этой задачей; он не запускает новый сбор и не увеличивает исходный лимит результатов.

Каждая возвращенная запись поста стоит 0,5 кредита, базовой платы нет. Для двух ссылок с лимитом 100 предварительная оценка составляет 100 кредитов; если задача вернет всего 30 постов, итоговое списание составит 15 кредитов.