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 배열은 커뮤니티가 쓰는 순서를 그대로 지키므로 첫 항목이 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을 제출하고 커뮤니티마다 규칙 목록 하나를 읽습니다.

  1. {"urls": ["https://www.reddit.com/r/AskReddit/"]}을 /v1/reddit/subreddit-rules로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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 값을 비교해, 다음 게시물을 올리기 전에 추가·삭제·수정된 규칙을 잡아내세요.

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 사용자가 활동하는 서브레딧을 회원 수, 소개와 함께 나열합니다.

다른 플랫폼 둘러보기

Reddit 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Reddit Subreddit Rules API — 자주 묻는 질문

Reddit Subreddit Rules API는 서브레딧 URL로 Reddit 커뮤니티의 게시 규칙을 가져오는 프로그래밍 인터페이스입니다. 서브레딧마다 규칙을 순서대로, 각 규칙의 짧은 제목과 전문과 함께 반환합니다.

https://www.reddit.com/r/AskReddit/ 같은 커뮤니티 URL을 urls 배열에 넣고, 작업이 성공하면 해당 행의 rules 배열을 읽으세요.

규칙 개수와 관계없이 반환된 서브레딧 하나당 0.5 크레딧입니다.