reddit/
comments

Собирайте публичные комментарии Reddit по URL публикаций: текст, данные автора и контекст ветки, временные метки и видимая вовлеченность в нормализованных записях.

Reddit Comments API

URL публикации на входе
Ссылки на ветку
Снимок вовлеченности
0,3 кредита за результат
Готово
Готово

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

README

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

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, отслеживайте асинхронную задачу и читайте нормализованные записи комментариев с курсорной пагинацией.

  1. Подготовьте один или несколько поддерживаемых URL публичных публикаций Reddit или короткие ссылки redd.it.
  2. Отправьте ссылки в поле urls на /v1/reddit/comments и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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.

Помимо 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 публикаций.

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

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

Reddit Comments API — FAQ

Reddit Comments API собирает записи публичных комментариев по поддерживаемым URL публикаций Reddit и возвращает нормализованный текст, данные автора, ссылки на исходную публикацию и родительский комментарий, временные метки и видимые метрики реакций.

Отправьте URL с http или https на reddit.com, www.reddit.com, old.reddit.com или new.reddit.com, путь которого начинается с /r/{subreddit}/comments/{post_id}. Короткие ссылки redd.it и www.redd.it тоже принимаются.

Нет. Reddit Comments API отклоняет results_limit и сохраняет записи комментариев, полученные для каждого принятого URL публикации; оплата зависит от фактического числа результатов.

Возвращенные записи содержат post_id, post_url, parent_comment_id, community_name и input_url, если эти значения доступны. Эти поля связывают возвращенные комментарии, но не обещают полную глубину ветки.

Нет. Комментарий может содержать post_id и post_url для контекста, но заголовок и текст исходной публикации не входят в нормализованную запись комментария.

Каждая возвращенная запись комментария стоит 0,3 кредита SocQ. За пустой набор результатов плата за результаты не взимается.