Reddit Posts
Публикация Reddit — это материал, размещенный в сообществе, публичная страница которого может показывать заголовок, текст, автора, флэр, медиа, время публикации и видимые сигналы голосования и комментариев. Если связать эти поля с сабреддитом и временем сбора, отдельную публикацию можно использовать для проверки источника, анализа контента и сравнения с привязкой ко времени.
Возможности Reddit Posts API
- Прямое получение публикацииПревращает допустимый URL обсуждения Reddit или короткую ссылку redd.it в нормализованную запись этой публичной публикации и отклоняет главные страницы сабреддитов и посторонние пути.
- Контент и авторство публикацииВозвращает ID публикации, публичный URL, заголовок, текст и доступные идентификаторы автора, чтобы каждую запись можно было соотнести с источником.
- Контекст сабреддита и классификацииПередает флэр, а также название сообщества, его URL и видимое число участников в extra, если источник их предоставляет.
- Медиа, вовлеченность и время сбораХранит ссылки на медиа, created_at, collected_at, upvotes_count, comments_count и upvote_ratio вместе в снимке с временной меткой.
Параметры Reddit Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных публикаций Reddit с путями /r/{subreddit}/comments/{post_id} на поддерживаемых хостах Reddit или коротких ссылок redd.it. |
Как использовать Reddit Posts API
Отправьте нужные публичные публикации, отслеживайте асинхронную задачу и читайте нормализованные записи с курсорной пагинацией.
- Подготовьте один или несколько URL публичных публикаций Reddit с поддерживаемым путем comments или короткие ссылки redd.it.
- Отправьте ссылки в поле urls на /v1/reddit/posts и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items, затем запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
-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 Posts API
- Проверка публикаций по источнику: Сохраняйте ID публикаций, URL, заголовки, текст и поля автора, чтобы проверяющие могли вернуться к тем самым публичным материалам, которые вошли в анализ.
- Сравнение тем в разных сообществах: Группируйте заголовки и текст по community_name и tag, чтобы изучать, как заданная тема подается в выбранных сабреддитах.
- Отслеживание вовлеченности во времени: Сохраняйте upvotes_count, comments_count и upvote_ratio вместе с collected_at, чтобы сравнивать повторные снимки, не считая значения неизменными.
Практические советы по Reddit Posts API
- Разворачивайте ссылки redd.it и удаляйте дубли по идентификатору публикации перед отправкой пакета: короткая ссылка и полный URL обсуждения могут вести на одну и ту же публикацию.
- Используйте этот эндпоинт, если URL публикаций уже известны: он не принимает главные страницы сабреддитов, поисковые запросы, параметры сортировки и results_limit.
- Допускайте значения null у автора, медиа, тега, сведений о сообществе, временных меток и метрик, если публичный источник их не показывает.
- Храните collected_at рядом с видимыми метриками вовлеченности, чтобы сравнивать последующие снимки, не перезаписывая время наблюдения.
Связанные API
Помимо Reddit Posts API, используйте эти API, когда нужен другой тип публичных данных Reddit.
- Reddit Comments API — Собирайте по поддерживаемым URL публикаций текст публичных комментариев, авторов, ссылки на публикацию и родительский комментарий, контекст сообщества, метки времени и видимую вовлеченность.
- Reddit Subreddit Posts API — Находите публичные публикации по URL сабреддитов с сортировкой new, top или hot, лимитом результатов на сабреддит и нормализованным контекстом сообщества и вовлеченности.
- 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: заголовок и текст, автор, рейтинг, комментарии и медиа.