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