Reddit Comments
Комментарий Reddit — это публичный ответ в обсуждении публикации с текстом, данными автора, ссылками на исходную публикацию и родительский комментарий, контекстом сообщества, временными метками и видимым числом голосов и ответов. Вместе эти поля делают возвращенные комментарии полезными для анализа реакций, построения карты ответов, архивирования со ссылкой на источник и сравнения с привязкой ко времени.
Возможности Reddit Comments API
- Комментарии из заданного обсужденияПринимает поддерживаемый URL публикации Reddit или короткую ссылку redd.it и возвращает записи публичных комментариев, полученные для этого обсуждения.
- Текст и авторство комментариевВозвращает доступные ID комментария, публичный URL, текст и идентификаторы автора в виде отдельной нормализованной записи.
- Ссылки на публикацию и ответыПередает post_id, post_url, parent_comment_id, community_name и input_url, чтобы связывать возвращенные комментарии с источником и друг с другом.
- Снимок видимых реакцийСохраняет upvotes_count и replies_count вместе с created_at и collected_at, чтобы отличать время публикации от времени наблюдения.
Параметры Reddit Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных публикаций Reddit с путями /r/{subreddit}/comments/{post_id} на поддерживаемых хостах Reddit или коротких ссылок redd.it. |
Как использовать Reddit Comments API
Отправьте URL публичных публикаций Reddit, отслеживайте асинхронную задачу и читайте нормализованные записи комментариев с курсорной пагинацией.
- Подготовьте один или несколько поддерживаемых URL публичных публикаций Reddit или короткие ссылки redd.it.
- Отправьте ссылки в поле urls на /v1/reddit/comments и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items, затем запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/example/comments/post_id/example_post/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Reddit Comments API
- Качественный анализ реакций: Анализируйте текст комментариев вместе с доступными полями автора, чтобы выявлять аргументы, вопросы и повторяющиеся реакции в выбранных обсуждениях.
- Карта связей между возвращенными ответами: Используйте ID комментариев и parent_comment_id, чтобы связывать ответы, которые есть в возвращенных записях, не предполагая, что ветка собрана целиком.
- Архивирование комментариев со ссылкой на источник: Сохраняйте URL комментариев, post_id, post_url, community_name и временные метки, чтобы каждый сохраненный ответ сохранял контекст обсуждения.
- Сравнение реакций с привязкой ко времени: Сравнивайте upvotes_count и replies_count у возвращенных комментариев, привязывая каждое наблюдение к collected_at.
Практические советы по Reddit Comments API
- Разворачивайте ссылки redd.it и удаляйте дубли по исходной публикации перед отправкой пакета, чтобы одно и то же обсуждение не попало в запрос под разными формами URL.
- Не передавайте results_limit: этот эндпоинт отклоняет его и сохраняет комментарии, полученные для каждого принятого URL публикации.
- Используйте parent_comment_id только для связи записей, которые действительно есть в наборе результатов: он не гарантирует полную глубину ветки.
- Допускайте значения null в тексте, полях автора, parent_comment_id, community_name, временных метках и метриках, если публичный источник их не передает.
- Продолжайте с next_cursor, пока has_more не станет false, чтобы не пропустить комментарии завершенной задачи на границе страницы результатов API.
Связанные API
Помимо Reddit Comments API, используйте эти API, когда нужен другой тип публичных данных Reddit.
- Reddit Posts API — Собирайте по поддерживаемым URL Reddit текст публичных публикаций, авторов, контекст сообщества, медиа, метки времени и видимую вовлеченность.
- Reddit Subreddit Posts API — Находите публичные публикации по URL сабреддитов с сортировкой new, top или hot, лимитом результатов на сабреддит и нормализованным контекстом сообщества и вовлеченности.
- Reddit Search API — Ищите публичные публикации Reddit по текстовому запросу и периоду публикации и получайте нормализованный контент, авторов, контекст сообщества, метки времени, медиа и видимую вовлеченность.
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- Reddit User Comments API — Собирайте историю комментариев пользователя Reddit по одному имени: отрывки из 300 символов, рейтинг, ссылки на комментарии и ID публикаций.