reddit/
posts

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

Reddit Posts API

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

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

README

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

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

Отправьте нужные публичные публикации, отслеживайте асинхронную задачу и читайте нормализованные записи с курсорной пагинацией.

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

Помимо 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: заголовок и текст, автор, рейтинг, комментарии и медиа.

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

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

Reddit Posts API — FAQ

Reddit Posts 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 Posts API получает конкретные URL публикаций из urls; он не принимает главные страницы сабреддитов, ключевые слова и параметры сортировки для поиска публикаций.

Нет. Этот эндпоинт принимает только urls, потому что каждый входной URL указывает на конкретную публикацию, а не на ленту, которую нужно ограничить.

Нет. Запись публикации может содержать видимое значение comments_count, но не текст комментариев и не их авторов.

Данные автора, медиа, флэр, контекст сообщества, время публикации и значения вовлеченности могут быть null или пустыми, если публичный источник не показывает пригодное значение.

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