reddit/
subreddit-details

커뮤니티 URL로 공개 서브레딧의 메타데이터를 조회하고, 구독자 수, 주간 활성 사용자, 규칙, 커뮤니티 이미지 자산을 반환합니다.

Reddit Subreddit Details API

서브레딧 메타데이터
커뮤니티 규모 파악
운영 규칙
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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을 하나 이상 비동기 작업으로 제출한 뒤, 폴링하여 정규화된 커뮤니티 프로필을 가져옵니다.

  1. https://www.reddit.com/r/technology/ 같은 공개 서브레딧 링크를 하나 이상 준비합니다.
  2. urls 배열을 담아 /v1/reddit/subreddit-details로 POST 요청을 보냅니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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와 함께 사용하면 규모 기준을 충족하는 커뮤니티의 최신 콘텐츠를 샘플링할 수 있습니다.

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로 번호가 매겨진 커뮤니티 규칙을 규칙별 짧은 제목, 전문과 함께 가져옵니다.

다른 플랫폼 둘러보기

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

Reddit Subreddit Details API — 자주 묻는 질문

Reddit Subreddit Details API는 일반적인 서브레딧 URL에서 Reddit 커뮤니티의 공개 메타데이터를 폭넓게 가져옵니다. 구독자 수, 주간 활성 참여자, 운영 규칙, 커뮤니티 브랜딩 자산을 제공합니다.

아니요. 모든 요청은 SocQ API 키로 인증하므로 Reddit 앱 등록이나 사용자 승인이 필요하지 않습니다.

네. urls 매개변수에 URL 배열을 전달하면 작업이 각 공개 커뮤니티의 메타데이터를 수집해 반환합니다.