Reddit Subreddit Posts
Публикации сабреддита — это публичные материалы сообщества с заголовками, текстом, авторами, флэром, медиа, временем публикации и видимыми сигналами голосования и комментариев. Эти поля контента, контекста и вовлеченности помогают отслеживать сообщества, исследовать темы и сопоставимо сравнивать списки публикаций разных сабреддитов.
Возможности Reddit Subreddit Posts API
- Поиск публикаций в списках сабреддитовНаходит публичные публикации по допустимым URL вида /r/{subreddit}; для всех сабреддитов в запросе выбирается список new, top или hot.
- Глубина сбора для каждого сабреддитаПрименяет results_limit к каждому переданному URL сабреддита отдельно: по умолчанию 100, допустимый диапазон — от 1 до 2 000.
- Нормализованный контент и авторы публикацийВозвращает идентификаторы публикаций, исходные URL, заголовки, текст, доступные поля автора и ссылки на медиа в единообразной структуре записи.
- Контекст сообщества и вовлеченностиСохраняет с каждой публикацией флэр, сведения о сообществе, время публикации и сбора, upvotes_count, comments_count, upvote_ratio и discovery_input.
Параметры Reddit Subreddit Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных сабреддитов Reddit с точным путем /r/{subreddit} на поддерживаемом хосте Reddit. |
results_limit | Необязательный | Максимальное число публикаций, запрашиваемых для каждого URL сабреддита; по умолчанию 100, допускаются целые числа от 1 до 2 000. |
sort_by | Необязательный | Список, применяемый ко всем переданным URL сабреддитов; по умолчанию new, поддерживаются new, top и hot. |
Как использовать Reddit Subreddit Posts API
Отправьте URL публичных сабреддитов с одним режимом списка и лимитом результатов на сабреддит, затем читайте результаты асинхронной задачи с курсорной пагинацией.
- Подготовьте один или несколько URL публичных сабреддитов Reddit с путем /r/{subreddit}.
- Отправьте urls, results_limit и sort_by методом POST на /v1/reddit/subreddit-posts, затем сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items и запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/learnpython/"],"results_limit":100,"sort_by":"new"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Reddit Subreddit Posts API
- Мониторинг публикаций сообществ: Собирайте список new и сохраняйте ID публикаций, created_at, collected_at, заголовки и текст, чтобы просматривать недавние публичные публикации в выбранных сабреддитах.
- Исследование тем сабреддитов: Группируйте заголовки, текст, флэр и поля сообщества, чтобы изучать повторяющиеся темы и форматы в заданных публичных сообществах.
- Сравнение списков в одном режиме: Используйте одно значение sort_by для всех URL сабреддитов и сравнивайте время публикации, upvotes_count, comments_count и upvote_ratio в одном режиме списка.
Практические советы по Reddit Subreddit Posts API
- Отправляйте канонический URL главной страницы /r/{subreddit}, а не название сабреддита, URL публикации или более глубокий путь, чтобы запрос прошел проверку URL.
- Считайте запрашиваемую глубину как число urls, умноженное на results_limit: лимит и оценка кредитов применяются к каждому сабреддиту отдельно.
- Запускайте отдельные задачи для сравнения new, top и hot: одно значение sort_by применяется ко всем URL сабреддитов в запросе.
- Сохраняйте discovery_input и collected_at с каждой записью, чтобы в последующих датасетах сохранялись исходный сабреддит и время наблюдения.
- Допускайте, что поля автора, медиа, флэра, сообщества, временных меток и вовлеченности могут быть null или пустыми, если публичный список их не показывает.
Связанные API
Помимо Reddit Subreddit Posts API, используйте эти API, когда нужен другой тип публичных данных Reddit.
- Reddit Posts API — Собирайте по поддерживаемым URL Reddit текст публичных публикаций, авторов, контекст сообщества, медиа, метки времени и видимую вовлеченность.
- Reddit Comments API — Собирайте по поддерживаемым URL публикаций текст публичных комментариев, авторов, ссылки на публикацию и родительский комментарий, контекст сообщества, метки времени и видимую вовлеченность.
- Reddit Search API — Ищите публичные публикации Reddit по текстовому запросу и периоду публикации и получайте нормализованный контент, авторов, контекст сообщества, метки времени, медиа и видимую вовлеченность.
- Reddit Subreddit Details API
- Reddit User Posts API — Собирайте историю публикаций пользователя Reddit по одному имени с сортировкой new, top или hot: заголовок и текст, рейтинг, комментарии и медиа.
- Reddit Popular Feed API — Собирайте публикации r/popular в порядке hot, best, new, rising или top: заголовок и текст, автор, рейтинг, комментарии и медиа.