Reddit Subreddit Rules
서브레딧 규칙은 Reddit 커뮤니티가 스스로 정한 번호 붙은 게시 가이드라인으로, 규칙마다 모더레이터가 신고 메뉴에 보여 주는 짧은 제목과 적용 범위를 설명하는 전체 문구가 있습니다. 글을 올리기 전에 읽어 두면 그 커뮤니티가 어떤 게시물을 반기고 어떤 게시물을 삭제하는지 알 수 있어, 출시 전 규정 점검, 여러 계정을 운영하는 팀의 공용 규칙집, 커뮤니티 간 나란히 비교에 도움이 됩니다.
Reddit Subreddit Rules API 주요 기능
- 요청당 여러 서브레딧urls 배열에는 https://www.reddit.com/r/AskReddit/ 같은 커뮤니티 주소를 넣으며, 서브레딧마다 r/ 이름과 url 값이 담긴 행 하나가 반환됩니다.
- 번호 순서를 유지한 규칙rules 배열은 커뮤니티가 쓰는 순서를 그대로 지키므로 첫 항목이 1번 규칙이고, "3번 규칙" 같은 언급은 세 번째 항목에 바로 대응합니다.
- 규칙마다 짧은 제목과 전문rules.name 값은 모더레이터가 신고 메뉴에 보여 주는 짧은 제목, rules.description 값은 규칙 전문, rules.id 값은 규칙 식별자입니다.
Reddit Subreddit Rules API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | https://www.reddit.com/r/{name}/ 형식의 서브레딧 URL을 하나 이상 넣습니다. old.reddit.com과 new.reddit.com 주소도 사용할 수 있습니다. |
Reddit Subreddit Rules API 사용 방법
서브레딧 URL을 제출하고 커뮤니티마다 규칙 목록 하나를 읽습니다.
- {"urls": ["https://www.reddit.com/r/AskReddit/"]}을 /v1/reddit/subreddit-rules로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 서브레딧별 rules 배열을 읽고, has_more 값이 true인 동안 results.next_cursor를 따라갑니다.
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 추천 활용 사례
- 출시 게시물의 규칙 위반 여부 점검: 제품 소개나 AMA 게시물을 올리기 전에 대상 서브레딧마다 rules.description 값을 읽고 형식, 링크, 문구가 허용되는지 확인합니다.
- 팀이 활동하는 모든 커뮤니티의 규칙집 관리: 서브레딧별 규칙을 collected_at 값과 함께 저장해 회사 계정으로 글을 올리는 모든 사람이 같은 최신 버전을 기준으로 작업하게 합니다.
- 커뮤니티 간 규칙 비교: 여러 서브레딧의 rules.name과 rules.description에서 홍보, 링크, 플레어 같은 용어를 검색해 캠페인에 맞는 커뮤니티를 가려냅니다.
Reddit Subreddit Rules API 활용 팁
- 제출 전에 모든 URL을 커뮤니티 루트인 /r/{name}/까지만 남기세요. 목록에 게시물 링크나 다른 경로가 하나라도 섞이면 요청 전체가 거부됩니다.
- rules.description 값은 Markdown으로 렌더링하세요. 모더레이터가 쓴 목록, 강조, 링크가 그대로 남아 있고 규칙의 긴 위키 버전으로 가는 링크도 포함됩니다.
- 실행할 때마다 rules.id와 rules.description 값을 비교해, 다음 게시물을 올리기 전에 추가·삭제·수정된 규칙을 잡아내세요.
관련 API
Reddit Subreddit Rules API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- 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 사용자가 활동하는 서브레딧을 회원 수, 소개와 함께 나열합니다.