Reddit API

공개 Reddit 데이터 API

Name: Reddit Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 공개 Reddit 데이터를 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기 동작 방식 직접 호출

/v1/reddit

활성 엔드포인트는 8개입니다. VoC 컴포지트는 1개입니다.

GET /v1/reddit/subreddit
GET /v1/reddit/subreddit/details
GET /v1/reddit/search
GET /v1/reddit/subreddit/search
GET /v1/reddit/post
GET /v1/reddit/post/comments
GET /v1/reddit/post/transcript
GET /v1/reddit/omni-search

Reddit 엔드포인트

공개 Reddit 읽기 엔드포인트는 8개입니다. 커뮤니티 카드, 피드, 검색, 게시물 본문, 중첩 댓글 트리, 영상 자막, 종량제 omni-search를 제공합니다. 데이터 API만 지원하며 투표, 관리 도구, 비공개 서브레딧은 포함되지 않습니다.

서브레딧 피드

1 크레딧

/v1/reddit/subreddit

커뮤니티 게시물을 반환합니다. 제목, 점수, 추천 비율, 댓글 수, 작성자, flair, permalink가 포함됩니다. 정렬 값은 best, hot, new, top, rising입니다.

subreddit, sort, timeframe, after

서브레딧 상세

1 크레딧

/v1/reddit/subreddit/details

커뮤니티 카드를 반환합니다. 구독자, 활성 사용자, 설명, 규칙, 아이콘이 포함됩니다. 이름은 대소문자를 구분합니다. AskReddit과 askreddit은 다릅니다.

subreddit or url

전체 검색

1 크레딧

/v1/reddit/search

Reddit 전체를 키워드로 검색합니다. 제목, 점수, 댓글 수, 서브레딧, permalink를 반환합니다. after로 페이지를 넘깁니다.

query, sort, timeframe, after

커뮤니티 검색

1 크레딧

/v1/reddit/subreddit/search

한 서브레딧 안에서 검색합니다. 전체 검색과 같은 게시물 목록 형태를 반환합니다.

subreddit, query, sort, timeframe

게시물 본문

1 크레딧

/v1/reddit/post

전체 URL로 게시물 1건을 가져옵니다. selftext를 포함합니다. content.text는 제목과 본문을 합친 값이며 ext.title과 ext.selftext로 나뉩니다. 링크 게시물의 selftext는 null입니다.

url

댓글 트리

5 크레딧

/v1/reddit/post/comments

중첩 댓글 트리를 한 호출로 가져옵니다. 서버가 load-more 분기를 펼칩니다. 잘리면 data.truncated와 ext.replies_cursor가 반환됩니다.

url, cursor, trim

영상 자막

10 크레딧

/v1/reddit/post/transcript

Reddit이 VTT를 공개한 영상 또는 v.redd.it URL의 자막을 반환합니다. 음성 인식이 아닙니다. 자막이 없으면 크레딧이 환불됩니다.

url, language

Omni search

종량제, 최소 5 크레딧

/v1/reddit/omni-search

키워드를 넣으면 검색 페이지, 상위 스레드 댓글 확장, 서브레딧 볼륨과 톤 요약을 가져옵니다. 동기 JSON 또는 SSE를 지원합니다. 검색 페이지당 1 크레딧, 확장 스레드당 1 크레딧이며 최소 5 크레딧입니다. 지연은 약 10-12초입니다.

구성은 사이트 검색, 상위 스레드 확장(1-8), 인라인 댓글, 서브레딧 볼륨과 톤입니다. 실패한 스레드는 과금하지 않습니다. Accept가 text/event-stream이면 SSE입니다.

Reddit API8개 엔드포인트 지원

문서 보기

서브레딧의 게시물을 돌려줍니다. 게시물마다 제목, 점수, 업보트 비율, 댓글 수, 작성자, 플레어, permalink, 작성 시각이 붙습니다.

커뮤니티 피드를 읽을 때 사용하세요. timeframe은 sort=top일 때만 적용되고 sort를 비우면 top이 자동으로 잡힙니다. 같은 커뮤니티를 키워드로 거르려면 subreddit/search를 쓰세요.

1크레딧

GET/v1/reddit/subreddit?subreddit=technology

subreddit

subreddit · Subreddit name without the r/ prefix

$ curl https://www.socialcrawl.dev/v1/reddit/subreddit?subreddit=technology \
    -H "x-api-key: sc_YOUR_API_KEY"

대기 중

// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Reddit API 동작

Reddit도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/reddit/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. Reddit OAuth와 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. Reddit OAuth 앱과 PRAW 비밀키는 필요 없습니다. TikTok, Instagram, Truth Social을 포함한 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

Reddit 라우트는 모두 GET입니다. subreddit, query, url, sort, timeframe, after, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

표준 읽기는 1 크레딧, 댓글 트리는 5 크레딧, 자막은 있을 때 10 크레딧입니다. omni-search는 종량제이며 최소 5 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 목록 응답은 after, cursor, has_more, truncated 페이지네이션을 가집니다.

연동 순서

대부분 제품은 매 틱마다 전 엔드포인트를 호출하지 않습니다. 커뮤니티를 확인한 뒤 피드를 보고 필요한 게시물만 깊게 읽습니다.

01커뮤니티

GET /v1/reddit/subreddit/details?subreddit=…

Author 형태 커뮤니티입니다. 구독자, 활동, 규칙, 아이콘이 포함됩니다.

서브레딧을 한 번 확정합니다. 대소문자 정규화가 필요합니다.

02피드

GET /v1/reddit/subreddit?subreddit=…&sort=top&timeframe=week

PostList입니다. items[]에 title, score, comments, post.url이 있습니다.

after로 페이지를 넘깁니다. trim으로 페이로드를 줄일 수 있습니다.

03게시물 본문

GET /v1/reddit/post?url=…

텍스트 게시물의 selftext를 포함한 전체 Post입니다.

검색과 피드 제목만으로는 본문이 부족할 때 사용합니다.

04댓글

GET /v1/reddit/post/comments?url=…

재귀 replies[]가 있는 CommentList입니다.

load-more를 직접 쫓지 않고 한 번의 고급 호출로 트리를 펼칩니다.

요청

GET /v1/reddit/subreddit
  ?subreddit=technology
  &sort=top
  &timeframe=week
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

# deepen a post from the feed
GET /v1/reddit/post?url=https://www.reddit.com/r/…/comments/…
GET /v1/reddit/post/comments?url=…

응답 봉투

{
  "success": true,
  "data": {
    "items": [
      {
        "post": {
          "id": "1abc234",
          "url": "https://www.reddit.com/r/technology/comments/…",
          "content": { "text": "Example title" },
          "engagement": { "likes": 4200, "comments": 318 },
          "ext": {
            "subreddit": "technology",
            "upvote_ratio": 0.94
          }
        }
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다. TikTok이나 X Post를 파싱하면 Reddit도 같습니다.

Authorsubreddit/details

id, username(서브레딧 이름), display_name, avatar_url, bio, followers(구독자), url, ext(규칙, 활성 사용자)

PostList / Postsubreddit, search, post

items[].post: id, url, content.text, engagement, author, published_at, ext(subreddit, upvote_ratio, flair, selftext)

CommentListpost/comments

items[]: author, content.text, engagement, published_at, replies[], ext.replies_cursor. 더 있으면 data.truncated

Transcript / Analyticstranscript, omni-search

transcript와 raw_vtt, 또는 omni 요약(스레드, 중첩 댓글, 서브레딧 볼륨과 톤)

게이트웨이

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Reddit 전용 사이드카가 아닙니다.

엣지 수신

Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.

검증 후 차감

레지스트리에서 reddit/subreddit 등을 찾습니다. 필수 파라미터와 URL 형식 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.

캐시 또는 조회

platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 Reddit 공개 영역을 실시간으로 읽습니다. 5xx와 네트워크 오류는 재시도하며 불건전 시 서킷 브레이커가 동작합니다.

정규화 후 반환

업스트림 JSON을 Author, Post, PostList, CommentList, Transcript로 매핑합니다. 필요 시 t1_와 t3_ 접두를 제거하고 Zod로 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.

과금 규칙

표준 라이브 미스는 1 크레딧입니다.
댓글 트리는 고정 5 크레딧입니다.
자막은 있을 때 10 크레딧입니다.
Omni-search는 종량제이며 최소 5 크레딧입니다.
캐시 히트는 0 크레딧입니다.
빈 응답과 하드 실패는 자동 환불됩니다.
잘못된 파라미터는 400이며 과금하지 않습니다.
잔액이 없으면 402이며 과금하지 않습니다.
비활성 ads 라우트는 503이며 과금하지 않습니다.

데이터 수집

Reddit은 공개 읽기 소셜 데이터입니다. SocialCrawl 스키마로 정규화하므로 Reddit 전용 타입이나 두 번째 OAuth를 코드에 넣을 필요가 없습니다.

API에서의 Reddit

공개 커뮤니티, 게시물, 스레드 댓글을 읽기 전용으로 제공합니다. 리서치, 모니터링, 제품 작업에 사용합니다. 투표, 관리, 비공개 서브레딧 접근은 없습니다.

업스트림

피드, 검색, 댓글, 게시물 상세, 자막, omni 레그를 요청 시점에 실시간으로 읽어 엣지에서 정규화한 뒤 전달합니다. 각 경로를 어떤 방식으로 수집하는지는 예고 없이 바뀔 수 있지만 호출 형식과 응답 봉투는 그대로입니다.

응답 형태

success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 서브레딧은 Author로, 게시물과 댓글은 TikTok·X와 같은 리프 형태로 정규화됩니다.

미제공 항목

쓰기 엔드포인트는 없습니다. 사용자 프로필과 사용자 게시물 라우트는 없습니다. ad와 ads/search는 등록되어 있으나 업스트림 실패 후 비활성입니다. 자막은 Reddit이 VTT를 공개할 때만 제공됩니다.

필드 매핑

subreddit / community→ author.*이름, 구독자, 설명, 규칙, 아이콘

submission title + selftext→ post.content.text + ext.*점수, upvote_ratio, 댓글, flair, 서브레딧

comment tree / more children→ CommentList + replies[]서버가 load-more를 확장합니다. 예산이 끝나면 절단됩니다.

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

8active Reddit endpoints in the registry

1 / 5 / 10표준, 댓글, 자막 크레딧 사다리

커뮤니티 모니터링과 VoC 스윕

호출은 서브레딧 피드, 키워드 검색, 게시물에서 댓글로 이어지는 체인에 집중됩니다. 여러 커뮤니티 스레드가 필요하면 omni-search가 사용됩니다. 댓글 트리는 고정 5 크레딧입니다. URL로 게시물 본문을 가져올 수 있고 종량제 VoC 컴포지트가 있습니다. Reddit OAuth 앱은 필요 없습니다.

피드와 상세는 라이브 미스 시 보통 수 초입니다. 검색과 omni-search는 API에서 가장 느린 소셜 읽기 경로이며 종종 10-12초입니다.

Reddit API 활용 사례

Reddit 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

소셜 리스닝불리언 검색과 전체 댓글 트리를 제공합니다. 대용량 소스 중 가장 안정적입니다.

댓글 수집전체 댓글 트리를 페이지당 정액으로 수집합니다. 레딧 OAuth 설정이 필요하지 않습니다.

트렌드 감지해당 검색어가 길게 논의되는 지점을 찾고 스레드 전체를 확인합니다.

시장 조사불리언 검색과 전체 댓글 트리를 제공합니다. 대용량 소스 중 가장 안정적이며 창업자와 구매자, 실무자가 공개적으로 논쟁하는 곳입니다.

영상 자막본문이 이미 텍스트입니다. 스레드와 댓글 트리에 자막 단계가 필요하지 않아 콘텐츠 파이프라인에서 가장 저렴한 레인입니다.

뉴스·공개출처 모니터링불리언 검색과 전체 댓글 트리를 제공합니다. 대용량 소스 중 가장 안정적이며 주장이 반복되지 않고 반박되는 곳입니다.

리뷰 인텔리전스불리언 검색과 전체 댓글 트리를 제공합니다. 실제 리뷰 조사가 반드시 포함하는 필터 없는 대조군이며 대용량 소스 중 가장 안정적입니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

커뮤니티 모니터

Python, cron, Slack 봇

고정 서브레딧의 hot 또는 top을 폴링합니다. subreddit과 선택적 details를 사용합니다. 점수나 댓글 속도가 급증하면 알립니다.

VoC 팀

Node, 노트북, BI 적재

키워드 검색 또는 omni-search 후 본문과 댓글 트리를 펼쳐 브랜드, 제품, 경쟁 언어를 확인합니다.

백엔드 제품 잡

Go, 워커, Explorer

커뮤니티, 피드, 게시물, 댓글을 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다. 카탈로그와 같은 API 키를 사용합니다.

호출 예시

표준 티어는 라이브 호출당 1 크레딧입니다. 캐시 히트는 무료입니다. 댓글 트리와 자막은 상위 티어입니다.

curl "https://www.socialcrawl.dev/v1/reddit/subreddit?subreddit=technology&sort=top&timeframe=week" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/reddit/search?query=social+media+api&sort=relevance&timeframe=month" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl Reddit

카탈로그와 같은 API 키

플랫폼 문서 API 키 받기

엔드포인트

Reddit API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

SubredditList Reddit subreddit posts Subreddit DetailsGet Reddit subreddit details SearchSearch Reddit posts PostGet a Reddit post Post CommentsList Reddit post comments Subreddit SearchSearch within a subreddit Post TranscriptGet a Reddit video post transcript Omni SearchReddit VoC sweep: one keyword → threads across all of Reddit with subreddit attribution and top comments inline.

비교

SocialCrawl과 공식 Reddit API, 뭐가 다른가요?

같은 Reddit 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

항목	SocialCrawl	공식 Reddit API
인증	x-api-key 헤더 하나면 돼요	클라이언트 ID·시크릿과 OAuth 2.0이 필요해요
설정·심사	가입 후 바로 호출할 수 있어요	개발자 앱 등록이 필요하고 상업적 사용은 별도 승인을 받아야 해요
레이트 리밋	크레딧 기반이라 쓴 만큼만 차감돼요	클라이언트별 호출 한도가 빡빡하고 2023년부터 상업용은 유료예요
응답 스키마	51개 플랫폼 공통 통합 JSON이에요	kind 접두사가 붙은 Reddit 전용 객체를 직접 파싱해야 해요
요금	호출당 1 크레딧(댓글 스레드는 5, 영상 트랜스크립트는 10), 100 크레딧 무료예요	소량은 무료지만 상업용 요금제 도입 후 대부분의 서드파티 앱이 멈췄어요
데이터 범위	서브레딧·검색·댓글·트랜스크립트 등 공개 데이터 읽기 전용이에요	포스팅, 투표, 모더레이션까지 읽기·쓰기 전부 가능해요
유지보수	Reddit 내부가 바뀌어도 스키마가 유지돼요	OAuth 토큰 갱신과 정책 변경을 직접 따라가야 해요

인증

SocialCrawl

x-api-key 헤더 하나면 돼요

공식 Reddit API

클라이언트 ID·시크릿과 OAuth 2.0이 필요해요

설정·심사

SocialCrawl

가입 후 바로 호출할 수 있어요

공식 Reddit API

개발자 앱 등록이 필요하고 상업적 사용은 별도 승인을 받아야 해요

레이트 리밋

SocialCrawl

크레딧 기반이라 쓴 만큼만 차감돼요

공식 Reddit API

클라이언트별 호출 한도가 빡빡하고 2023년부터 상업용은 유료예요

응답 스키마

SocialCrawl

51개 플랫폼 공통 통합 JSON이에요

공식 Reddit API

kind 접두사가 붙은 Reddit 전용 객체를 직접 파싱해야 해요

요금

SocialCrawl

호출당 1 크레딧(댓글 스레드는 5, 영상 트랜스크립트는 10), 100 크레딧 무료예요

공식 Reddit API

소량은 무료지만 상업용 요금제 도입 후 대부분의 서드파티 앱이 멈췄어요

데이터 범위

SocialCrawl

서브레딧·검색·댓글·트랜스크립트 등 공개 데이터 읽기 전용이에요

공식 Reddit API

포스팅, 투표, 모더레이션까지 읽기·쓰기 전부 가능해요

유지보수

SocialCrawl

Reddit 내부가 바뀌어도 스키마가 유지돼요

공식 Reddit API

OAuth 토큰 갱신과 정책 변경을 직접 따라가야 해요

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

Reddit 데이터는 어떻게 수집하나요?

SocialCrawl이 서브레딧 게시물, 서브레딧 상세, 전체 검색, 게시물 댓글, 서브레딧 내 검색, 영상 게시물 트랜스크립트를 비롯해 Reddit 엔드포인트 8종을 제공해요. x-api-key 하나만 있으면 되고, Reddit 개발자 앱이나 OAuth, PRAW 없이 바로 호출할 수 있어요.

SocialCrawl은 어떤 Reddit 엔드포인트를 지원하나요?

서브레딧 게시물 목록, 서브레딧 상세 정보(구독자·규칙·아이콘), 전체 검색, 게시물 댓글 스레드, 서브레딧 내 검색, 영상 게시물 트랜스크립트를 비롯해 총 8개 엔드포인트예요. 모두 같은 통합 스키마로 응답을 받아볼 수 있어요.

Reddit API는 요금이 얼마인가요?

대부분의 Reddit 엔드포인트는 1 크레딧(스탠다드 티어)이에요. 댓글 스레드는 댓글 트리 전체를 자동으로 확장해서 5 크레딧이고, 영상 게시물 트랜스크립트는 작업이 무거워서 10 크레딧(프리미엄 티어)이에요. 새 계정은 100 크레딧을 무료로 받을 수 있고, 신용카드 없이 바로 시작할 수 있어요.

Reddit 개발자 앱이나 OAuth 토큰이 필요한가요?

필요 없어요. Reddit 개발자 계정, 클라이언트 ID·시크릿, OAuth 리프레시 토큰 전부 필요 없어요. SocialCrawl x-api-key와 서브레딧 이름 또는 URL만 있으면 공개 데이터를 바로 받아볼 수 있고, 응답 스키마가 다른 플랫폼과 똑같이 통일돼 있어요.

공식 Reddit API의 대체제로 써도 되나요?

네, 2023년 Reddit 요금제 변경 이후 PRAW나 써드파티 도구가 멈춘 상황에서 대체제로 쓰시는 분이 많아요. 레이트리밋 협상이나 OAuth 연동 없이, 어떤 엔드포인트든 같은 스키마로 응답해서 개발이 훨씬 쉽고 간편해요.

가장 좋은 Reddit 스크레이퍼 API는 무엇인가요?

공개 Reddit 데이터를 읽는 용도라면 SocialCrawl을 추천해요. 서브레딧 피드, 서브레딧 상세, 전체·서브레딧 내 검색, 댓글 스레드, 영상 트랜스크립트를 비롯해 엔드포인트 8종을 쓸 수 있어요. 대부분 호출당 1 크레딧이고, 댓글 스레드는 5 크레딧, 트랜스크립트는 10 크레딧이에요. OAuth 앱이나 PRAW 설정 없이 100 크레딧 무료로 시작할 수 있어요.

Reddit 데이터 스크래핑, 법적으로 괜찮을까요?

SocialCrawl은 누구나 볼 수 있는 공개 Reddit 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Reddit 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

Reddit API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요