Собирайте вместе целевые посты, предшествующий контекст и связи ответов с помощью SocQ. Упорядочивайте обсуждения в Twitter/X по тому, кто кому ответил, а затем используйте ID обсуждения и ID прямого родителя для чтения, анализа, сводок и фильтрации веток автора.
SocQ X Thread Context API запрашивает целевой публичный пост, более ранние посты цепочки ответов и ответы, которые вернул источник. В этом руководстве разбираются сбор, группировка обсуждений, выгрузка связей «родитель — потомок» и фильтрация веток автора.
Коротко: отправьте URL публичного поста на
POST /v1/x/thread-contextи прочитайте страницы результатов завершенной задачи. Группируйте поconversation_idи связывайте прямых родителей черезin_reply_to_id. Если тело родительского поста отсутствует, сохраните ссылку на него и отметьте пробел.
Поиск поста, ответы или контекст ветки
| Что нужно | Эндпоинт SocQ | Начальные входные данные |
|---|---|---|
| Сам выбранный пост | X Posts | URL публичных постов |
| Ответы на выбранный пост | X Post Replies | URL публичных постов |
| Целевой пост, более ранние посты цепочки ответов и доступные ответы | X Thread Context | URL публичных постов |
| Посты, опубликованные в сообществе | X Community Posts | URL публичных сообществ |
Используйте 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_id | ID прямого родительского поста | Найдите этот ID и свяжите посты |
id | Идентификатор текущего поста | Индексируйте посты и удаляйте дубликаты |
Следующие условные данные поясняют связи:
| Пост | Автор | Обсуждение | Прямой родитель |
|---|---|---|---|
| A | Alice | A | Не указан |
| B | Alice | A | A |
| C | Bob | A | B |
| D | Alice | A | C |
Все четыре поста относятся к обсуждению 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 и изучите нужное обсуждение.
Источники и дополнительные материалы
- Документация SocQ 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