Reddit User Comments
История комментариев пользователя Reddit — это след из ответов, которые аккаунт оставляет в чужих обсуждениях, и у каждого есть отрывок сказанного, рейтинг, время написания, ссылка на комментарий и публикация, к которой он относится. Комментарии часто показывают знания и интересы человека нагляднее, чем его собственные публикации, поэтому они помогают оценивать экспертов и потенциальных клиентов, следить за тем, как аккаунт говорит о продукте, и изучать язык сообщества через его самых активных участников.
Возможности Reddit User Comments API
- История комментариев по одному имениusername принимает один аккаунт, sort_by упорядочивает его комментарии по new, top или hot, а results_limit собирает от 1 до 1 000 комментариев, по умолчанию 100.
- Прямая ссылка на каждый комментарийurl открывает комментарий внутри его обсуждения, так что из любой строки можно сразу перейти к полному ответу и дискуссии вокруг него.
- Ссылка на публикацию у каждого ответаpost_id указывает публикацию, под которой оставлен комментарий, — по нему ответы группируются по обсуждениям и связываются с данными публикаций.
- Рейтинг каждого комментарияmetrics.likes_count содержит рейтинг комментария — быстрый показатель того, как ответ восприняли другие читатели.
Параметры Reddit User Comments API
| Параметры | Обязательный | Описание |
|---|---|---|
username | Обязательный | Одно имя пользователя Reddit с префиксом u/ или без него, из 3–20 букв, цифр, дефисов или подчеркиваний. |
sort_by | Необязательный | Порядок комментариев: new (по умолчанию), top или hot. |
results_limit | Необязательный | Максимальное число комментариев, целое число от 1 до 1 000; по умолчанию 100. |
Как использовать Reddit User Comments API
Отправьте одно имя пользователя с порядком сортировки и лимитом, затем читайте комментарии страница за страницей.
- Отправьте {"username": "spez", "sort_by": "top", "results_limit": 100} методом POST на /v1/reddit/user-comments.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте комментарии из results.items; если has_more равно true, передайте results.next_cursor, чтобы получить следующую страницу.
curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"spez","sort_by":"top","results_limit":100}'Сценарии использования Reddit User Comments API
- Оценка экспертов и потенциальных клиентов: Читайте отрывки text и likes_count комментариев кандидата, чтобы понять, отвечает ли он со знанием дела и хорошо ли его принимают.
- Отслеживание высказываний аккаунта о продукте: Фильтруйте text по названиям вашего бренда или продуктов, открывайте url ради полного ответа и по published_at следите за мнением одного аккаунта во времени.
- Изучение языка сообщества через активных участников: Соберите комментарии нескольких постоянных участников сабреддита и сравните формулировки и рейтинги, чтобы понять, как говорит эта аудитория.
Практические советы по Reddit User Comments API
- Превращайте post_id в короткую ссылку https://redd.it/{post_id} и отправляйте ее в Reddit Posts API, если нужны заголовок обсуждения, сообщество и рейтинг.
- Используйте sort_by top с небольшим results_limit, чтобы получить самые высоко оцененные ответы аккаунта, не собирая всю историю.
- Храните комментарии по id и пропускайте уже сохраненные id при повторном запуске того же имени, чтобы повторные проверки не создавали дубликатов.
Связанные API
Помимо Reddit User Comments API, используйте эти API, когда нужен другой тип публичных данных Reddit.
- Reddit Posts API — Собирайте по поддерживаемым URL Reddit текст публичных публикаций, авторов, контекст сообщества, медиа, метки времени и видимую вовлеченность.
- Reddit Comments API — Собирайте по поддерживаемым URL публикаций текст публичных комментариев, авторов, ссылки на публикацию и родительский комментарий, контекст сообщества, метки времени и видимую вовлеченность.
- Reddit Subreddit Posts API — Находите публичные публикации по URL сабреддитов с сортировкой new, top или hot, лимитом результатов на сабреддит и нормализованным контекстом сообщества и вовлеченности.
- Reddit Search API — Ищите публичные публикации Reddit по текстовому запросу и периоду публикации и получайте нормализованный контент, авторов, контекст сообщества, метки времени, медиа и видимую вовлеченность.
- Reddit User Profile API — Проверяйте аккаунты Reddit по имени пользователя: общая карма и карма за публикации и комментарии, счетчики активности, возраст аккаунта и отметки профиля.
- Reddit User Posts API — Собирайте историю публикаций пользователя Reddit по одному имени с сортировкой new, top или hot: заголовок и текст, рейтинг, комментарии и медиа.