Reddit 공개 데이터 API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
사용할 수 있는 Reddit API
알고 있는 게시물 하나는 Posts, 그 게시물의 공개 답글은 Comments, 커뮤니티 피드는 Subreddit Posts, 키워드 기반 탐색은 Search를 사용합니다.

reddit/posts
게시물결과당 0.5 크레딧

reddit/comments
댓글결과당 0.3 크레딧

reddit/subreddit-posts
게시물결과당 0.5 크레딧

reddit/search
검색결과당 0.6 크레딧

reddit/subreddit-details
프로필결과당 0.5 크레딧

reddit/subreddit-search
검색결과당 0.6 크레딧

reddit/user-profile
프로필결과당 0.5 크레딧

reddit/user-posts
게시물결과당 0.5 크레딧

reddit/user-comments
댓글결과당 0.3 크레딧

reddit/user-active-subreddits
프로필요청당 0.5 크레딧

reddit/popular-feed
게시물결과당 0.5 크레딧

reddit/trending-searches
검색요청당 0.5 크레딧

reddit/subreddit-rules
프로필결과당 0.5 크레딧

reddit/answers
검색결과당 6 크레딧
어떤 Reddit 데이터를 가져올 수 있나요?
SocQ는 토론 분석에 쓸 수 있도록 커뮤니티, 답글, 탐색, 참여도, 수집 시점 정보가 담긴 정규화된 공개 Reddit 콘텐츠를 반환합니다.
게시물과 공개된 참여도
제목, 본문 텍스트, 작성자, 플레어, 커뮤니티 정보, 미디어, 출처 URL, collected_at 기준의 공개 지표를 가져옵니다.
댓글과 답글 관계
공개 댓글 텍스트, 작성자, 원본 게시물·상위 댓글 참조, 타임스탬프, 업보트 수, 답글 수를 가져옵니다.
서브레딧 탐색
/r/{subreddit} URL의 새 글·인기 글·핫 게시물을 둘러보며, 커뮤니티마다 별도의 결과 상한을 적용합니다.
키워드 검색
텍스트 검색어와 게시 기간으로 공개 게시물을 검색하며, 일치한 게시물과 탐색 정보를 함께 보존합니다.
SocQ vs Reddit Data API
SocQ는 공개 Reddit 수집 워크플로를 제공합니다. Reddit의 Data API는 Reddit 데이터에 접근하거나 수정하는 승인된 앱을 위한 공식 인터페이스입니다.
| 기능 | SocQ | Reddit Data API |
|---|---|---|
| 주요 용도 | 공개 게시물, 댓글, 서브레딧 목록, 검색 결과 수집 | 승인된 Reddit 앱, 연동, 모더레이션 도구 구축 |
| 인증 | SocQ API 키만 사용하며 Reddit 사용자 OAuth 불필요 | Reddit 승인, OAuth 자격 증명, 선언된 앱 식별 정보 |
| 시작 입력 | 공개 게시물 또는 서브레딧 URL, 또는 텍스트 검색어 | Reddit 엔드포인트, fullname, 목록 매개변수, OAuth 스코프 |
| 게시·투표·모더레이션 | 지원하지 않음 | 필요한 사용자 스코프가 있는 승인된 용도에서 지원 |
| 응답 형식 | 정규화된 SocQ 레코드 | Reddit 고유 객체와 목록 |
Reddit API 작동 방식
직접 수집, 서브레딧 탐색, 키워드 검색 모두 같은 비동기 작업과 페이지네이션 결과 흐름을 따릅니다.
1. 입력 제출
게시물 URL, 서브레딧 URL, 검색어를 알맞은 API에 보내고 반환된 task_id를 저장합니다.
2. 작업 추적
처리가 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 결과 가져오기
data.results.items를 읽고, has_more가 true인 동안 next_cursor를 사용합니다.
SocQ API 키로 인증하고 키워드와 게시 기간을 제출합니다. 다른 Reddit API도 같은 작업 흐름을 따릅니다.
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"machine learning","results_limit":100,"published_within":"month"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueReddit API 주요 활용 사례
커뮤니티 모니터링
선택한 서브레딧의 새 글·인기 글·핫 게시물을 수집하고, 커뮤니티별로 공개된 활동량을 비교합니다.
토론·반응 분석
선택한 토론 안에서 게시물 내용, 댓글 텍스트, 답글 관계, 작성자, 수집 시점의 참여도를 살펴봅니다.
주제·시장 리서치
정해 둔 키워드와 기간으로 검색해 제품, 브랜드, 경쟁사, 트렌드를 둘러싼 공개 토론을 찾습니다.
리서치 아카이브와 데이터셋
공개 게시물, 댓글, 출처 링크, 커뮤니티 정보, 타임스탬프, 공개 지표를 보존해 반복 가능한 분석에 활용합니다.
제한 사항과 공개 데이터 정책
Reddit 결과는 특정 시점의 공개 레코드입니다. 이 API들은 비공개 커뮤니티, 삭제된 콘텐츠, 계정 데이터, 모더레이션 기능에 접근하지 않습니다.
- Posts와 Comments는 지원하는 게시물 URL이나 redd.it 링크를 받습니다. Subreddit Posts에는 정확한 /r/{subreddit} 경로가 필요합니다.
- Subreddit Posts는 새 글·인기 글·핫 정렬을 지원하며, results_limit은 서브레딧 URL마다 따로 적용됩니다.
- Search는 검색어 하나, 1~2,000 범위의 results_limit, hour·day·week·month·year·all 중 하나의 게시 기간을 받습니다. 서브레딧이나 정렬 필터는 제공하지 않습니다.
- Posts와 Comments는 별개의 리소스입니다. 게시물에는 comments_count가 포함되지만 개별 댓글 레코드는 포함되지 않습니다.
- Comments는 공개된 댓글을 반환하지만, 전체 답글 트리나 과거 토론의 모든 깊이까지 보장하지는 않습니다.
- 공개 지표는 collected_at 기준의 스냅샷입니다. 공개 원본에서 노출하지 않는 선택 필드는 null이거나 비어 있을 수 있습니다.
Reddit API 자주 묻는 질문
Reddit API란 무엇인가요?
Reddit API는 알고 있는 공개 게시물과 댓글을 가져오고, 서브레딧 게시물을 둘러보고, 키워드와 게시 기간으로 공개 토론을 검색하는 SocQ 엔드포인트 모음입니다.
어떤 Reddit 링크를 사용할 수 있나요?
Posts와 Comments는 지원하는 /r/{subreddit}/comments/{post_id} 경로나 redd.it 링크를 받습니다. Subreddit Posts는 정확한 /r/{subreddit} 경로를 받습니다.
어떤 Reddit API를 선택해야 하나요?
알고 있는 게시물은 Posts, 그 공개 답글은 Comments, 커뮤니티 목록은 Subreddit Posts, 키워드 기반 탐색은 Search를 사용하세요.
서브레딧 탐색과 Reddit 검색은 어떻게 다른가요?
Subreddit Posts는 정확한 /r/{subreddit} URL에서 새 글·인기 글·핫 게시물을 둘러봅니다. Search는 텍스트 검색어 하나와 게시 기간으로 공개 게시물을 찾습니다.
Reddit 댓글과 참여도 지표는 완전하거나 실시간인가요?
아니요. Comments는 수집 시점에 반환된 공개 답글을 반영하며, 참여도 값은 전체 이력이나 실시간 피드가 아니라 특정 시점의 스냅샷입니다.
Reddit 수집 요금은 어떻게 되나요?
Posts나 Subreddit Posts 결과는 1건당 0.5 크레딧, 댓글은 1건당 0.3 크레딧, Search 결과는 1건당 0.6 크레딧입니다. 빈 결과에는 결과 요금이 부과되지 않습니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.
Threads API
공개 Threads 프로필을 가져오고, 알고 있는 게시물을 확인하거나, 선택한 프로필의 게시물을 수집합니다. 식별 정보, 콘텐츠, 미디어, 참여도, 타임스탬프 필드가 정규화되어 제공됩니다.
Bluesky API
공개 Bluesky 프로필을 가져오고, 알고 있는 게시물 URL을 확인하거나, 계정 게시물 한 페이지를 수집해 정규화된 신원 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여 필드로 받아 봅니다.
Snapchat API
알고 있는 공개 Snapchat Spotlight 하나를 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 참여도 필드가 포함된 정규화된 레코드로 가져옵니다.
Twitch API
알고 있는 공개 Twitch 사용자 이름을 정규화된 프로필로 확인하거나 공개 동영상 목록을 수집하고, 클립 하나를 내려받을 수 있는 동영상과 함께 가져와 크리에이터 리서치, 카탈로그 정보 보강, 비교, 스냅샷 모니터링에 활용합니다.
Rednote API
공개 프로필과 노트를 가져오고, 노트나 사용자를 검색하고, 댓글과 중첩 답글을 수집하고, 홈 추천 페이지 하나를 가져옵니다.