Reddit을 연동하는 올바른 방법은 제품이 실제로 무엇을 하느냐에 따라 달라집니다. 커뮤니티 안에 설치하는 운영 봇, 비상업적 OAuth 클라이언트, 학술 연구, 상업용 소셜 리스닝 제품은 접근 경로도 책임도 같지 않습니다.
이 가이드에서는 현재 Reddit이 제공하는 공식 옵션을 설명하고, 애플리케이션에 관리형 읽기 전용 데이터 엔드포인트가 필요할 때 SocQ로 공개 게시물, 댓글, 서브레딧 피드, 서브레딧 메타데이터, 검색 결과를 가져오는 방법을 보여 드립니다.
빠른 답변: Reddit 안에서 실행되는 앱에는 Reddit 공식 Developer Platform을 쓰고, 사용 사례가 정책에 맞는다면 공식 Data API를 신청하세요. 다른 소셜 플랫폼과 함께 API 키 하나로 정규화된 공개 Reddit 레코드가 필요하다면 SocQ를 사용하세요. 어느 쪽을 택하더라도 Reddit의 약관, 삭제된 콘텐츠 요건, 개인정보 권리, 모델 학습 제한을 무시해도 된다는 허가는 아닙니다.
접근 요건과 정책은 2026년 7월 19일에 확인했습니다. Reddit은 승인 규칙과 한도를 바꿀 수 있으므로, 출시 전에 링크된 공식 문서를 다시 확인하세요.
어떤 Reddit API를 써야 할까요?
Reddit은 현재 서로 다른 여러 개발자 인터페이스를 소개하고 있습니다.
| 제품 | 용도 | 중요한 경계 |
|---|---|---|
| Developer Platform (Devvit) | Reddit 안에서 실행되는 게임, 유틸리티, 운영 앱 | Reddit 경험에 맞춰 만든 앱 |
| Data API | 승인된 프로그램 방식의 Reddit 데이터 읽기·수정 | OAuth, 심사, 정책, 속도 제한 적용 |
| Reddit for Researchers | 자격을 갖춘 학술 연구 | 공식 연구 경로, 신청 필요 |
| Ads API | 캠페인과 보고서를 관리하는 광고주 | 광고 워크플로이며 일반 커뮤니티 데이터가 아님 |
| Reddit Embeds | 개별 Reddit 콘텐츠 표시 | 대량 데이터 접근이 아닌 표시용 |
| 관리형 공개 데이터 API | 안정적인 스키마의 공개 레코드가 필요한 제품 워크플로 | 업체의 지원 범위와 약관이 별도로 적용 |
Reddit의 개발자 접근 개요에 따르면 Data API는 승인된 개발자를 위한 것이고, 학술 연구는 Reddit for Researchers를 이용해야 합니다. 상업적 이용에는 Reddit의 허가와 계약이 필요합니다.
따라서 API를 정할 때는 코드 라이브러리보다 먼저 사용 사례를 분류해야 합니다.
2026년 Reddit 공식 Data API 요건
자격이 되는 무료 Data API 이용에는 현재 등록된 OAuth 토큰과 설명적인 User-Agent가 필요합니다. 인증 없는 트래픽은 표준 허용량이 적용되지 않고 차단될 수 있습니다.
Reddit 공식 Data API 위키에는 OAuth 클라이언트 ID당 분당 100쿼리라는 한도가 10분 평균 기준으로 명시되어 있습니다. 클라이언트는 다음 헤더를 읽어야 합니다.
X-Ratelimit-UsedX-Ratelimit-RemainingX-Ratelimit-Reset
분당 100쿼리를 상업용 요금제의 일반 기준으로 받아들이면 안 됩니다. 무료 접근 자격이 있는 사용자에게 공개된 한도일 뿐입니다. Reddit은 유료 제품, 광고 기반 제품, 구독 서비스, 요금을 받고 판매하는 서비스를 포함한 상업적 이용에는 사전 허가가 필요하다고 밝히고 있습니다. 더 넓은 범위나 유료 접근은 공개된 셀프서비스 요금표가 아니라 별도로 처리됩니다.
Reddit은 삭제 처리도 요구합니다. 현재 안내에 따르면 Reddit에서 삭제된 저장 콘텐츠는 사용자 시스템에서도 삭제해야 하고, 삭제된 계정과 연결된 작성자 식별 정보도 제거해야 합니다. 규정 준수를 쉽게 하려면 저장한 사용자 데이터와 콘텐츠를 48시간 이내에 주기적으로 삭제할 것을 문서에서 권장합니다.
공식 API 인증 예시
설치형 또는 스크립트 애플리케이션은 보통 클라이언트 자격 증명과 사용자 승인을 OAuth 토큰으로 교환한 뒤, 그 토큰을 oauth.reddit.com으로 보냅니다.
단순화한 요청 형태는 다음과 같습니다.
curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
-H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
-H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"
운영 환경의 클라이언트는 다음을 갖춰야 합니다.
- 올바른 사용 사례로 등록하고 승인을 받습니다.
- 해당하는 OAuth grant를 구현합니다.
- 지원되는 경우 만료되는 토큰을 갱신합니다.
- 사실에 맞는 고유한 User-Agent를 보냅니다.
- 속도 제한 헤더를 지키고 한도가 소진되기 전에 백오프합니다.
- 삭제 요청과 정책 변경을 처리합니다.
Python 개발자는 리스팅 객체, 페이지네이션, OAuth 세부 사항을 처리하기 위해 PRAW를 많이 씁니다. 의존성을 줄이고 싶다면 직접 HTTP를 쓰는 것도 괜찮지만, 그렇다고 정책상의 의무가 사라지지는 않습니다.
SocQ로 URL에서 Reddit 게시물 가져오기
SocQ의 Reddit Posts API는 공개 Reddit 게시물 URL과 redd.it 단축 링크를 받습니다. 정규화된 제목, 본문, 작성자, 커뮤니티 정보, 타임스탬프, 공개 미디어 참조, 화면에 보이는 참여 지표를 반환합니다.
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
이 요청은 비동기 작업을 생성합니다. 반환된 task_id를 저장한 뒤 다음과 같이 폴링하세요.
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
-H "Authorization: Bearer $SOCQ_API_KEY"
작업이 성공하면 레코드는 data.results.items에 있습니다. has_more가 true인 동안은 next_cursor로 계속 가져오세요.
게시물 레코드는 다른 SocQ 리소스와 같은 상위 구조를 따릅니다.
{
"id": "post_id",
"platform": "reddit",
"resource": "posts",
"type": "post",
"url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
"name": "Example post title",
"text": "Example post body",
"author": {
"username": "example_user",
"name": "example_user"
},
"metrics": {
"upvotes_count": 842,
"comments_count": 54,
"upvote_ratio": 0.96
},
"created_at": "2026-07-16T08:00:00Z",
"collected_at": "2026-07-19T08:00:00Z",
"extra": {
"tag": "Discussion",
"community_name": "learnpython"
}
}
화면에 보이는 점수는 스냅샷이며 영구적인 기준값이 아닙니다. Reddit은 투표 수를 흐리게 처리할 수 있고, 콘텐츠는 수정되거나 삭제될 수 있으며, 나중에 다시 수집하면 값이 달라질 수 있습니다.
Reddit 댓글 가져오기
알고 있는 게시물 URL 아래의 공개 토론이 필요할 때는 Reddit Comments API를 사용하세요.
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
정규화된 댓글 레코드에는 다음이 포함됩니다.
- 댓글 ID, URL, 텍스트.
- 가능한 경우 공개 작성자 필드.
- 화면에 보이는 추천 수와 답글 수.
- 원본 게시물과 커뮤니티 참조.
- 가능한 경우 부모 댓글 ID.
- 게시 시각과 수집 시각.
현재 SocQ 엔드포인트는 results_limit 입력을 받지 않습니다. 보이는 모든 분기, 접힌 답글, 삭제된 댓글, 운영자 전용 항목, 동적으로 순위가 정해지는 결과가 전부 반환되리라고 가정하지 마세요. 스레드를 완전히 재구성하는 것이 필수 요건이라면 업체를 정하기 전에 깊고 큰 대표 스레드로 직접 테스트하세요.
서브레딧의 새 글, 인기 글, 화제 글 가져오기
커뮤니티를 모니터링할 때는 Reddit Subreddit Posts API가 공개 서브레딧 URL을 하나 이상 받습니다. sort_by는 new, top, hot을 지원하고, results_limit은 제출한 서브레딧마다 1부터 2,000까지 받습니다.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/",
"https://www.reddit.com/r/webdev/"
],
"sort_by": "new",
"results_limit": 250
}'
정렬 방식은 의도를 갖고 고르세요.
| 정렬 | 적합한 용도 | 한계 |
|---|---|---|
new | 증분 모니터링과 알림 | 신호가 약한 게시물이 더 많이 포함됨 |
hot | 커뮤니티의 현재 관심사 | 순위가 계속 바뀜 |
top | 참여도가 높은 콘텐츠 발굴 | 오래되었거나 이미 인기 있는 콘텐츠가 과대 반영될 수 있음 |
모니터링에는 new를 일정에 맞춰 수집하고 게시물 ID로 중복을 제거하세요. hot이나 top은 시간순 피드를 덮어쓰지 말고 별도의 탐색용 뷰로 쓰세요.
키워드로 Reddit 게시물 검색하기
Reddit Search API는 검색어, 1부터 2,000까지의 결과 제한, 게시 기간을 받습니다.
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "\"social listening\" API",
"results_limit": 500,
"published_within": "month"
}'
지원하는 기간은 hour, day, week, month, year, all입니다.
검색 결과는 순위가 매겨진 탐색 결과이며 전체를 보장하는 아카이브가 아닙니다. 쿼리 문법, 순위, 가용성, 색인이 모두 지원 범위에 영향을 줍니다. 넓은 쿼리 하나로 대화 전체를 대표할 수 있다고 기대하지 말고, 범위가 좁은 쿼리를 여러 개 실행하세요.
예를 들어 브랜드 모니터링이라면 다음과 같은 쿼리 세트를 쓰세요.
"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative
분석가가 각 레코드가 데이터셋에 들어온 이유를 설명할 수 있도록 탐색 맥락에 쿼리를 저장하세요.
서브레딧 상세 정보와 서브레딧 내 검색
커뮤니티 자체를 다루는 엔드포인트가 두 개 더 있습니다. Reddit Subreddit Details API는 공개 서브레딧 URL을 받아 구독자 수, 주간 활성 사용자, 규칙, 커뮤니티 에셋 같은 메타데이터를 반환합니다. 모니터링하기 전에 커뮤니티를 가늠해 보는 저렴한 방법입니다.
Reddit Subreddit Search API는 특정 서브레딧 하나 안에서 검색어, 기간, 정렬 기준으로 공개 토론과 게시물을 검색합니다. 브랜드 용어가 몇몇 커뮤니티에서만 의미가 있어 Reddit 전체 검색에서는 묻혀 버릴 때 사용하세요. 정확한 입력 필드는 각 엔드포인트 페이지에서 확인하세요.
안정적인 Reddit 모니터링 파이프라인 구축
내구성 있는 워크플로는 수집, 저장, 분석을 분리합니다.
Query/subreddit registry
↓
Scheduled SocQ submissions
↓
Task polling with backoff
↓
Normalize + deduplicate by Reddit ID
↓
Deletion/retention controls
↓
Classification, alerts and reporting
권장하는 구현 규칙은 다음과 같습니다.
- 안정적인 ID를 사용하세요. URL과 슬러그는 바뀔 수 있으므로 Reddit ID가 더 나은 중복 제거 키입니다.
- 출처 맥락을 보존하세요. 서브레딧, 쿼리, 정렬, 수집 시각을 저장하세요.
- 스냅샷과 엔터티를 분리하세요. 지표는 바뀌지만 게시물 ID는 그대로입니다.
- 개별 레코드가 아니라 작업을 재시도하세요. 지수 백오프를 쓰면 중복 제출을 피할 수 있습니다.
- 누락 및 삭제 상태를 기록하세요. 부재를 비어 있지만 유효한 게시물로 바꾸지 마세요.
- 개인 데이터를 최소화하세요. 대부분의 분석에는 작성자 단위의 장기 이력이 필요하지 않습니다.
- 삭제 경로를 마련하세요. 데이터 모델에서 콘텐츠와 작성자 참조를 제거할 수 있어야 합니다.
Reddit 공식 API와 SocQ 비교
| 요구 사항 | Reddit 공식 API | SocQ |
|---|---|---|
| Reddit 위에서 앱이나 운영 도구 구축 | 가장 적합 | 지원 안 함 |
| Reddit 읽기·쓰기 작업 | 승인·스코프에 따라 지원 | 읽기 전용 공개 데이터 |
| OAuth와 Reddit 앱 등록 | 필수 | SocQ API 키 |
| 공개 게시물·댓글 정규화 | Reddit 고유 객체 | 공통 SocQ 스키마 |
| 멀티 플랫폼 소셜 제품 | 연동을 각각 구현 | 27개 플랫폼에 같은 작업 모델 |
| 공개된 무료 속도 제한 | 자격이 되는 OAuth 클라이언트에 분당 100쿼리 | SocQ 카탈로그의 엔드포인트별 요금 |
| 상업적 이용 허가 | Reddit의 허가·계약 필요 | 업체를 통한 접근이 Reddit 규정을 면제하지 않음 |
| 학술 연구 | Reddit for Researchers 필수 | 정책 우회 수단으로 사용 금지 |
사용자 승인 작업, 운영, 게시, 투표, 메시지 전송, Reddit 고유의 깊은 연동을 수행하는 제품이라면 공식 경로를 선택하세요. 쓰기 권한보다 정규화된 멀티 플랫폼 레코드와 관리형 추출이 더 중요한 지원 대상 공개 데이터 수집이라면 SocQ를 선택하세요.
워크로드와 비용 추정
업체를 "요청 수"만으로 비교하지 마세요. 요청 하나가 게시물 하나를 반환할 수도, 댓글 한 페이지를 반환할 수도, 서브레딧 결과 수백 건을 반환할 수도 있습니다.
다음과 같이 추정하세요.
monthly records =
direct post lookups
+ comments returned
+ subreddit posts returned
+ search results returned
monthly workload =
schedules × inputs per run × average records per input
그런 다음 다음 요소를 반영하세요.
- 비어 있거나 조회할 수 없는 결과.
- 새로 고침 주기.
- 검색 중복과 중복 제거.
- 깊은 댓글 스레드.
- 스토리지와 삭제 처리.
- 동시 처리와 지연 시간 요건.
- 성공한 결과만 과금되는지 여부.
연간 지출을 예측하기 전에 작은 커뮤니티와 큰 커뮤니티를 모두 포함한 대표 파일럿을 실행하세요.
책임 있는 사용과 데이터 보관
공개되어 있다고 해서 모든 용도에 대한 포괄적 허가가 되는 것은 아닙니다. Reddit의 현행 정책은 승인 없는 상업적 접근을 제한하고, 명시적 동의 없이 Reddit 콘텐츠로 모델을 학습하는 것을 금지합니다. 삭제 의무도 부과합니다.
규모를 키우기 전에 다음 통제 장치를 갖추세요.
- 명시한 목적에 필요한 필드만 수집합니다.
- 민감한 개인에 대한 프로파일링과 개인 괴롭힘을 피합니다.
- API로 서브레딧이나 계정 제한을 우회하지 않습니다.
- 콘텐츠를 표시할 때는 출처 표기를 유지합니다.
- 원본 콘텐츠의 보관 기간을 짧게 설정합니다.
- 더 이상 제공되지 않는 콘텐츠는 다시 확인하거나 제거합니다.
- API 키를 보호하고 내보내기 접근을 감사합니다.
- 상업적, 연구용, 고위험 용도는 법률 검토를 받습니다.
SocQ는 기술적인 접근 계층일 뿐이며 지식재산권, 개인정보, 연구, 상업적 권리를 부여하지 않습니다.
Reddit API 자주 묻는 질문(FAQ)
Reddit API는 무료인가요?
Reddit은 사용 사례에 따라 무료와 유료 접근을 모두 제공합니다. 자격이 되는 무료 Data API 클라이언트에는 현재 OAuth 클라이언트 ID당 분당 100쿼리 한도가 공개되어 있습니다. 상업적 이용에는 Reddit의 허가가 필요하며 계약과 요금이 필요할 수 있습니다.
OAuth 없이 Reddit API를 사용할 수 있나요?
인증 없는 접근을 전제로 설계하지 마세요. Reddit의 현행 문서는 등록된 OAuth 토큰을 요구하며, OAuth나 로그인 자격 증명이 없는 트래픽은 차단된다고 명시합니다.
AI 학습용으로 Reddit을 스크래핑해도 되나요?
Reddit은 명시적 동의 없이는 자사 콘텐츠를 모델 학습 입력으로 사용할 수 없다고 밝히고 있습니다. 서드파티 API를 쓴다고 해서 이 제한이 사라지지는 않습니다.
SocQ는 Reddit 댓글을 지원하나요?
네. SocQ에는 Reddit 엔드포인트가 여섯 개 있습니다. 게시물 직접 조회, 게시물 URL의 댓글, 서브레딧 게시물 탐색, 서브레딧 상세 정보, Reddit 전체 키워드 검색, 서브레딧 하나 안의 검색입니다.
SocQ로 Reddit에 글을 쓰거나 투표하거나 운영할 수 있나요?
아니요. SocQ의 Reddit 엔드포인트는 지원되는 공개 레코드를 수집합니다. 승인된 쓰기 작업과 운영에는 Reddit 공식 개발자 제품을 사용하세요.
Reddit 검색 결과는 전체를 포함하나요?
아니요. 검색은 순위가 매겨진 탐색으로 보세요. 결과는 쿼리, 기간, 색인, 가용성에 따라 달라지며 전체 과거 아카이브가 아닙니다.
Reddit 사용자가 콘텐츠를 삭제하면 어떻게 되나요?
시스템에서 해당 콘텐츠와 관련된 작성자 식별 정보를 제거할 수 있어야 합니다. Reddit 공식 안내는 규정 준수를 단순화하기 위해 저장한 사용자 데이터와 콘텐츠를 48시간 이내에 주기적으로 삭제할 것을 권장합니다.
REDDIT API
공개 Reddit URL로 워크플로를 테스트하세요
공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.
Reddit API 살펴보기