Reddit Subreddit Details
서브레딧은 주제별로 특화된 커뮤니티이며, 각기 다른 운영 지침과 참여자 활동, 도달 범위를 가지고 있습니다. 서브레딧 메타데이터를 수집하면 커뮤니티의 구독자 수, 주간 활성 사용자 추정치, 커뮤니티 규칙, 아이콘 이미지를 확인할 수 있습니다.
Reddit Subreddit Details API 주요 기능
- 커뮤니티 규모와 참여도서브레딧마다 전체 구독자 수, 주간 활성 사용자, 주간 기여 수를 추출합니다.
- 운영 규칙 추출사용자 참여를 규정하는 커뮤니티 지침과 게시 규칙을 마크다운 전문으로 가져옵니다.
- 브랜딩과 시각 자산커뮤니티 아이콘 이미지, 헤더 아트워크, 표시 이름, 광고 카테고리 분류를 수집합니다.
- 여러 URL 일괄 처리/r/{subreddit} URL 배열을 한 번의 요청으로 제출해 여러 커뮤니티를 한꺼번에 분석합니다.
Reddit Subreddit Details API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 메타데이터를 가져올 공개 Reddit /r/{subreddit} 커뮤니티 URL의 배열입니다. |
Reddit Subreddit Details API 사용 방법
서브레딧 URL을 하나 이상 비동기 작업으로 제출한 뒤, 폴링하여 정규화된 커뮤니티 프로필을 가져옵니다.
- https://www.reddit.com/r/technology/ 같은 공개 서브레딧 링크를 하나 이상 준비합니다.
- urls 배열을 담아 /v1/reddit/subreddit-details로 POST 요청을 보냅니다.
- status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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/)를 가리켜야 합니다.
- extra 메타데이터의 weekly_active_users와 weekly_contributions 필드는 커뮤니티의 활성도를 가늠하는 믿을 만한 지표입니다.
- 서브레딧 이름은 display_name과 name 필드 모두에서 원래의 대소문자가 그대로 유지됩니다.
- Reddit Subreddit Posts와 함께 사용하면 규모 기준을 충족하는 커뮤니티의 최신 콘텐츠를 샘플링할 수 있습니다.
관련 API
Reddit Subreddit Details API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- 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로 번호가 매겨진 커뮤니티 규칙을 규칙별 짧은 제목, 전문과 함께 가져옵니다.