reddit/
subreddit-details

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

Reddit Subreddit Details API

Метаданные сабреддита
Размер сообщества
Правила модерации
0,5 кредита за результат
Готово
Готово

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

README

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

Reddit Subreddit Details

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

Возможности Reddit Subreddit Details API

  • Размер и активность сообществаИзвлекает общее число подписчиков, еженедельно активных пользователей и число еженедельных публикаций и комментариев для каждого сабреддита.
  • Извлечение правил модерацииПолучает полные правила сообщества в формате Markdown и правила публикации, которые регулируют участие пользователей.
  • Оформление и визуальные материалыСохраняет иконки сообщества, изображения шапки, отображаемые названия и рекламные категории.
  • Пакетная обработка нескольких URLОтправляйте массив URL вида /r/{subreddit} в одном запросе для сводного анализа сообществ.

Параметры Reddit Subreddit Details API

ПараметрыОбязательныйОписание
urlsОбязательныйМассив URL публичных сообществ Reddit вида /r/{subreddit}, для которых нужно получить метаданные.

Как использовать Reddit Subreddit Details API

Отправьте один или несколько URL сабреддитов как асинхронную задачу, затем опрашивайте ее, чтобы получить нормализованные профили сообществ.

  1. Подготовьте одну или несколько ссылок на публичные сабреддиты, например https://www.reddit.com/r/technology/.
  2. Отправьте POST-запрос на /v1/reddit/subreddit-details с массивом urls.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Читайте data.results.items, чтобы получить нормализованные метаданные сообществ.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-details" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.reddit.com/r/technology/"]}'

# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.

Сценарии использования Reddit Subreddit Details API

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

Практические советы по Reddit Subreddit Details API

  • URL должны указывать на корень сообщества (например, /r/technology/), а не на отдельные ветки публикаций.
  • Поля weekly_active_users и weekly_contributions в extra служат надежными показателями состояния сообщества.
  • Названия сабреддитов сохраняют исходный регистр в полях display_name и name.
  • Сочетайте с Reddit Subreddit Posts, чтобы получать актуальный контент сообществ, которые подходят по размеру.

Помимо Reddit Subreddit Details API, используйте эти API, когда нужен другой тип публичных данных Reddit.

  • Reddit Posts API — Собирайте по поддерживаемым URL Reddit текст публичных публикаций, авторов, контекст сообщества, медиа, метки времени и видимую вовлеченность.
  • Reddit Subreddit Posts API — Находите публичные публикации по URL сабреддитов с сортировкой new, top или hot, лимитом результатов на сабреддит и нормализованным контекстом сообщества и вовлеченности.
  • Reddit Subreddit Search API
  • Reddit User Profile API — Проверяйте аккаунты Reddit по имени пользователя: общая карма и карма за публикации и комментарии, счетчики активности, возраст аккаунта и отметки профиля.
  • Reddit User Active Subreddits API — Получайте по одному имени список сабреддитов, в которых активен пользователь Reddit, с числом участников и описаниями.
  • Reddit Subreddit Rules API — Получайте пронумерованные правила сабреддитов по их URL: короткое название и полный текст каждого правила.

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

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

Reddit Subreddit Details API — FAQ

Reddit Subreddit Details API получает подробные публичные метаданные сообществ Reddit по стандартным URL сабреддитов. Он предоставляет число подписчиков, еженедельно активных участников, правила модерации и оформление сообщества.

Нет. Все запросы проходят аутентификацию по вашему API-ключу SocQ, поэтому регистрировать приложение Reddit или получать авторизацию пользователя не нужно.

Да. Передайте массив URL в параметре urls; задача соберет и вернет метаданные для каждого публичного сообщества.