reddit/
subreddit-rules

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

Reddit Subreddit Rules API

URL сабреддита на входе
Правила по порядку
Полный текст правил
0,5 кредита за результат
Готово
Готово

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

README

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

Reddit Subreddit Rules

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

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

  • Несколько сабреддитов за запросurls принимает адреса сообществ, например https://www.reddit.com/r/AskReddit/, и каждый сабреддит возвращается одной строкой с именем r/ и url.
  • Правила в их порядке нумерацииrules сохраняет порядок, принятый в сообществе, поэтому первый элемент — это первое правило, а отсылка вида «правило 3» указывает прямо на третий элемент.
  • Короткое название и полный текст каждого правилаrules.name содержит короткое название, которое модераторы показывают в меню жалоб, rules.description — полный текст правила, а rules.id идентифицирует правило.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОдин или несколько URL сабреддитов в формате https://www.reddit.com/r/{name}/; адреса old.reddit.com и new.reddit.com тоже подходят.

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

Отправьте URL сабреддитов и получите по одному списку правил на сообщество.

  1. Отправьте {"urls": ["https://www.reddit.com/r/AskReddit/"]} методом POST на /v1/reddit/subreddit-rules.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте массив rules каждого сабреддита из results.items и переходите по results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.reddit.com/r/AskReddit/"]}'

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

  • Проверка публикации к запуску на соответствие правилам: Читайте rules.description для каждого целевого сабреддита перед публикацией о продукте или AMA, чтобы убедиться, что ее формат, ссылки и формулировки разрешены.
  • Свод правил для всех сообществ команды: Сохраняйте правила каждого сабреддита с collected_at, чтобы все, кто публикует с аккаунтов компании, работали с одной актуальной версией.
  • Сравнение правил разных сообществ: Ищите в rules.name и rules.description по многим сабреддитам такие термины, как promotion, links или flair, чтобы понять, какие сообщества подходят для кампании.

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

  • Обрезайте каждый URL до корня сообщества /r/{name}/ перед отправкой: ссылка на публикацию или любой другой путь в списке отклоняет весь запрос.
  • Отображайте rules.description как Markdown: в нем сохраняются списки, выделения и ссылки модераторов, включая ссылки на развернутые версии правила в вики.
  • Сравнивайте rules.id и rules.description между запусками, чтобы заметить добавленные, удаленные или переписанные правила до выхода следующей публикации.

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

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

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

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

Reddit Subreddit Rules API — FAQ

Reddit Subreddit Rules API — это программный интерфейс для получения правил публикации сообществ Reddit по URL их сабреддитов. Он возвращает правила каждого сабреддита по порядку с коротким названием и полным текстом каждого правила.

Добавьте URL сообщества, например https://www.reddit.com/r/AskReddit/, в urls и прочитайте массив rules его строки после успешного завершения задачи.

Каждый возвращенный сабреддит стоит 0,5 кредита независимо от числа правил.