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 сабреддитов как асинхронную задачу, затем опрашивайте ее, чтобы получить нормализованные профили сообществ.
- Подготовьте одну или несколько ссылок на публичные сабреддиты, например https://www.reddit.com/r/technology/.
- Отправьте POST-запрос на /v1/reddit/subreddit-details с массивом urls.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте 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, чтобы получать актуальный контент сообществ, которые подходят по размеру.
Связанные API
Помимо 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: короткое название и полный текст каждого правила.