Xветки Twitterвложенные ответыConversation IDруководство по API

API веток Twitter: контекст обсуждения и вложенные ответы

Получайте контекст веток Twitter/X с помощью SocQ. Группируйте обсуждения, связывайте ответы и фильтруйте ветки автора кодом на Python, затем выгружайте JSON для анализа.

SocQОбновлено 16 октября 2026 г.8 мин чтения

Собирайте вместе целевые посты, предшествующий контекст и связи ответов с помощью SocQ. Упорядочивайте обсуждения в Twitter/X по тому, кто кому ответил, а затем используйте ID обсуждения и ID прямого родителя для чтения, анализа, сводок и фильтрации веток автора.

SocQ X Thread Context API запрашивает целевой публичный пост, более ранние посты цепочки ответов и ответы, которые вернул источник. В этом руководстве разбираются сбор, группировка обсуждений, выгрузка связей «родитель — потомок» и фильтрация веток автора.

Коротко: отправьте URL публичного поста на POST /v1/x/thread-context и прочитайте страницы результатов завершенной задачи. Группируйте по conversation_id и связывайте прямых родителей через in_reply_to_id. Если тело родительского поста отсутствует, сохраните ссылку на него и отметьте пробел.

Поиск поста, ответы или контекст ветки

Что нужноЭндпоинт SocQНачальные входные данные
Сам выбранный постX PostsURL публичных постов
Ответы на выбранный постX Post RepliesURL публичных постов
Целевой пост, более ранние посты цепочки ответов и доступные ответыX Thread ContextURL публичных постов
Посты, опубликованные в сообществеX Community PostsURL публичных сообществ

Используйте Thread Context, чтобы прочитать обсуждение, предшествующее выбранному посту. «Более ранние посты» — это посты, до которых можно дойти, двигаясь назад по связям с прямыми родителями.

Например, если B отвечает на A, а C отвечает на B, цепочка родителей C выглядит так: C → B → A. ID обсуждения определяют группировку, ID родительских постов — связи, а время публикации задает хронологический порядок отображения.

После сбора передайте текст и данные о связях в интерфейс для чтения или в отдельный процесс суммаризации.

Получение контекста ветки по URL публичного поста

Используйте публичный URL вида /status/{numeric_id}, заменив пример постом, который хотите изучить:

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": 100
  }'

На вход принимаются ссылки на публичные посты X и Twitter, включая ответ из середины обсуждения. Передавайте в urls полный URL вида /status/{numeric_id}.

data.task_id в ответе идентифицирует фоновую задачу. Сохраните его и запросите:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Ждите, пока задача находится в статусе queued, running или retrying. При failed изучите data.error_message. При succeeded читайте data.results.items и продолжайте с next_cursor, пока has_more равно true.

results_limit по умолчанию равен 100 и принимает целые числа от 1 до 2 000 для каждого входного URL. Два URL с лимитом 100 каждый независимо запрашивают до 100 записей. При объединении нескольких снимков одного обсуждения удаляйте дубликаты по ID поста.

Thread Context принимает любое целое число в этом диапазоне. Связи «родитель — потомок» стройте по полям связей после получения данных, а для перебора записей используйте порядок массива.

ID обсуждения и ID родительского поста

Два поля связей служат разным целям:

ПолеЗначениеОбработка
conversation_idОбсуждение, в которое входит постГруппируйте записи с одинаковым значением
in_reply_to_idID прямого родительского постаНайдите этот ID и свяжите посты
idИдентификатор текущего постаИндексируйте посты и удаляйте дубликаты

Следующие условные данные поясняют связи:

ПостАвторОбсуждениеПрямой родитель
AAliceAНе указан
BAliceAA
CBobAB
DAliceAC

Все четыре поста относятся к обсуждению A, а прямой родитель D — это C. Связывание по ID родителя сохраняет путь ответов D → C → B → A.

Определения полей см. в справочнике полей Thread Context. Используйте ID обсуждения и ID прямого родителя для соответствующих шагов группировки и связывания.

Стандартные записи также содержат текст, авторов, время публикации и сбора, медиа и счетчики вовлеченности. Поля, которые источник не вернул, остаются null.

Сбор сохраненных страниц результатов на Python

Сохраните этот вспомогательный модуль на стандартной библиотеке как socq_collect.py:

import json
import os
import time
from urllib.parse import urlencode
from urllib.request import Request, urlopen

BASE = "https://api.socq.ai/v1"
PENDING = {"queued", "running", "retrying"}

def api(method, path, payload=None):
    body = json.dumps(payload).encode("utf-8") if payload is not None else None
    request = Request(
        BASE + path, data=body, method=method,
        headers={
            "Authorization": "Bearer " + os.environ["SOCQ_API_KEY"],
            "Content-Type": "application/json",
        },
    )
    with urlopen(request, timeout=60) as response:
        result = json.load(response)
    if result.get("code") != 200:
        raise RuntimeError(result)
    return result["data"]

def collect(endpoint, payload):
    task_id = api("POST", "/" + endpoint, payload)["task_id"]
    print("Task:", task_id, flush=True)
    path = "/tasks/" + task_id
    deadline = time.monotonic() + 600
    data = api("GET", path + "?limit=100")
    while data["status"] in PENDING:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume GET " + path + "; do not resubmit automatically")
        time.sleep(2)
        data = api("GET", path + "?limit=100")
    if data["status"] != "succeeded":
        raise RuntimeError(data.get("error_message") or data["status"])

    items, seen_cursors = [], set()
    while True:
        if time.monotonic() >= deadline:
            raise TimeoutError("Resume pagination for " + task_id)
        page = data["results"]
        items.extend(page["items"])
        if not page["has_more"]:
            return task_id, items
        cursor = page.get("next_cursor")
        if not cursor or cursor in seen_cursors:
            raise RuntimeError("Missing or repeated result cursor")
        seen_cursors.add(cursor)
        data = api("GET", path + "?" + urlencode({"limit": 100, "cursor": cursor}))
        if data["status"] != "succeeded":
            raise RuntimeError("Task is not ready for result pagination")

Сохраните следующий скрипт как collect_thread.py в той же папке:

import json
import sys
from socq_collect import collect

if len(sys.argv) != 2:
    raise SystemExit("Usage: python3 collect_thread.py PUBLIC_POST_URL")
payload = {"urls": [sys.argv[1]], "results_limit": 100}
task_id, posts = collect("x/thread-context", payload)
with open("thread-context.json", "w", encoding="utf-8") as output:
    json.dump({"task_id": task_id, "input": payload, "items": posts},
              output, ensure_ascii=False, indent=2)

Задайте SOCQ_API_KEY и запустите скрипт с выбранным публичным постом:

python3 collect_thread.py \
  "https://x.com/BaganiTohid/status/2110635249889919362"

thread-context.json сохраняет входные ссылки, ID задачи и записи. Вспомогательный модуль ждет на стороне клиента до десяти минут. После тайм-аута сохраните выведенный ID задачи и продолжайте проверять задачу на сервере.

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

Связи ответов по ID прямого родителя

Проиндексируйте посты по ID, затем добавьте связи «родитель — потомок». Если тело родителя, на который есть ссылка, отсутствует, сохраните ID и установите parent_in_dataset в false.

Сохраните это как build_thread.py:

import json
import sys

if len(sys.argv) not in (2, 3):
    raise SystemExit("Usage: python3 build_thread.py INPUT_JSON [THREAD_AUTHOR_ID]")
with open(sys.argv[1], encoding="utf-8") as source:
    records = json.load(source)["items"]
author_id = sys.argv[2] if len(sys.argv) == 3 else None

nodes, missing_id_records = {}, []
for post in records:
    if post.get("id"):
        nodes[str(post["id"])] = post
    else:
        missing_id_records.append(post)

edges, groups, unknown_conversation_ids, unknown_parent_ids = [], {}, [], []
for post_id, post in nodes.items():
    conversation_id = post.get("conversation_id")
    if conversation_id:
        groups.setdefault(str(conversation_id), []).append(post_id)
    else:
        unknown_conversation_ids.append(post_id)
    parent_id = post.get("in_reply_to_id")
    if parent_id is None:
        unknown_parent_ids.append(post_id)
    else:
        parent_id = str(parent_id)
        edges.append({
            "parent_id": parent_id, "child_id": post_id,
            "parent_in_dataset": parent_id in nodes,
        })

self_reply_edges = []
if author_id:
    for edge in edges:
        parent = nodes.get(edge["parent_id"])
        child = nodes[edge["child_id"]]
        if parent and edge["parent_id"] != edge["child_id"]:
            parent_author = (parent.get("author") or {}).get("id")
            child_author = (child.get("author") or {}).get("id")
            if parent_author == author_id and child_author == author_id:
                self_reply_edges.append(edge)

graph = {
    "nodes": list(nodes.values()), "edges": edges, "conversation_groups": groups,
    "missing_parent_ids": sorted({
        edge["parent_id"] for edge in edges if not edge["parent_in_dataset"]
    }),
    "unknown_conversation_post_ids": unknown_conversation_ids,
    "unknown_parent_post_ids": unknown_parent_ids,
    "records_without_id": missing_id_records,
    "selected_author_id": author_id, "selected_author_self_reply_edges": self_reply_edges,
}
with open("thread-graph.json", "w", encoding="utf-8") as output:
    json.dump(graph, output, ensure_ascii=False, indent=2)

Постройте выгрузку связей:

python3 build_thread.py thread-context.json

Получившийся thread-graph.json содержит:

  • Уникальные узлы постов с идентификаторами, а также отдельно сохраненные записи без ID.
  • Связи «родитель — потомок» с полем parent_in_dataset, которое показывает, присутствует ли родитель.
  • Группы для известных ID обсуждений и отдельный список для отсутствующих ID обсуждений.
  • ID родителей, на которые есть ссылки, но для которых нет собранного поста.
  • ID постов, у которых поле прямого родителя равно null.

in_reply_to_id=null означает, что запись не содержит ссылки на прямого родителя; программа добавляет ее в unknown_parent_post_ids. Если ID родителя есть, но его записи нет в индексе, сохраните связь и отметьте отсутствующего родителя.

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

Ветка автора отдельно от ответов читателей

В условных данных Alice написала A, B и D. Переход от A к B — фрагмент, где автор отвечает сам себе, а D — ответ Alice пользователю Bob. Фильтруйте по ID автора, чтобы прочитать все высказывания автора, а затем проверяйте ID авторов и родителя, и потомка, чтобы найти фрагменты с ответами самому себе.

Если вы знаете ID аккаунта автора ветки, передайте эту строку вторым аргументом:

python3 build_thread.py thread-context.json THREAD_AUTHOR_ID

selected_author_self_reply_edges хранит связи, у которых и родитель, и потомок принадлежат указанному автору. Перед фильтрацией подтвердите ID автора: входная ссылка может указывать как на пост автора, так и на ответ читателя.

Выберите связный фрагмент ответов самому себе вокруг поста автора, который хотите прочитать. Если у автора несколько ответов самому себе на один родительский пост, выгрузка сохраняет эти ветви, чтобы интерфейс для чтения мог выбрать область отображения.

Храните полные записи и представление, отфильтрованное по автору, вместе, чтобы последующие фильтры для чтения могли опираться на исходные данные.

Выгрузка контекста для чтения, анализа или суммаризации

Показывайте в интерфейсе для чтения исходные URL, авторов, время публикации и связи с родителями, а также маркеры отсутствующих родителей. Сохраняйте JSON со связями рядом с текстовыми или Markdown-выгрузками, чтобы позже восстановить структуру.

Процесс суммаризации читает текст постов и связи, отдельно обрабатывает высказывания автора и ответы читателей и сохраняет маркеры пробелов в контексте. Thread Context поставляет записи; сводку генерирует ваша модель или ваше приложение.

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

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

Один набор контекстных данных для чтения, анализа и сводок

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

Откройте Thread Context и изучите нужное обсуждение.

Источники и дополнительные материалы

FAQ

Можно ли начать с ответа, а не с первого поста?

Да. Передайте URL этого публичного ответа в urls. Задача читает целевой пост, предшествующие публичные посты и ответы, которые вернул источник, в пределах заданного лимита.

Это то же самое, что получение ответов на пост?

Post Replies сосредоточен на ответах на выбранный пост. Thread Context читает целевой пост, предшествующие посты и ответы, чтобы упорядочить контекст через связи ответов.

Возвращает ли API все ответы в обсуждении?

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

Как обрабатывать ответы на ответы?

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

Почему отсутствует родительский пост, на который есть ссылка?

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

Как оставить только ветку исходного автора?

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

Можно ли сохранить ветку для ИИ-сводки?

Да. Сохраните собранные тексты, авторов, время и связи в JSON, затем запустите отдельный шаг суммаризации. Храните маркеры отсутствующего контекста и исходные URL вместе со сводкой.

X API

Проверить сценарий на публичном URL X

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для X