API 목록으로 돌아가기
Reddit 공개 데이터

Reddit 공개 데이터 API

알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.

사용할 수 있는 Reddit API

알고 있는 게시물 하나는 Posts, 그 게시물의 공개 답글은 Comments, 커뮤니티 피드는 Subreddit Posts, 키워드 기반 탐색은 Search를 사용합니다.

어떤 Reddit 데이터를 가져올 수 있나요?

SocQ는 토론 분석에 쓸 수 있도록 커뮤니티, 답글, 탐색, 참여도, 수집 시점 정보가 담긴 정규화된 공개 Reddit 콘텐츠를 반환합니다.

게시물과 공개된 참여도

제목, 본문 텍스트, 작성자, 플레어, 커뮤니티 정보, 미디어, 출처 URL, collected_at 기준의 공개 지표를 가져옵니다.

댓글과 답글 관계

공개 댓글 텍스트, 작성자, 원본 게시물·상위 댓글 참조, 타임스탬프, 업보트 수, 답글 수를 가져옵니다.

서브레딧 탐색

/r/{subreddit} URL의 새 글·인기 글·핫 게시물을 둘러보며, 커뮤니티마다 별도의 결과 상한을 적용합니다.

키워드 검색

텍스트 검색어와 게시 기간으로 공개 게시물을 검색하며, 일치한 게시물과 탐색 정보를 함께 보존합니다.

SocQ vs Reddit Data API

SocQ는 공개 Reddit 수집 워크플로를 제공합니다. Reddit의 Data API는 Reddit 데이터에 접근하거나 수정하는 승인된 앱을 위한 공식 인터페이스입니다.

기능SocQReddit Data API
주요 용도공개 게시물, 댓글, 서브레딧 목록, 검색 결과 수집승인된 Reddit 앱, 연동, 모더레이션 도구 구축
인증SocQ API 키만 사용하며 Reddit 사용자 OAuth 불필요Reddit 승인, OAuth 자격 증명, 선언된 앱 식별 정보
시작 입력공개 게시물 또는 서브레딧 URL, 또는 텍스트 검색어Reddit 엔드포인트, fullname, 목록 매개변수, OAuth 스코프
게시·투표·모더레이션지원하지 않음필요한 사용자 스코프가 있는 승인된 용도에서 지원
응답 형식정규화된 SocQ 레코드Reddit 고유 객체와 목록

Reddit API 작동 방식

직접 수집, 서브레딧 탐색, 키워드 검색 모두 같은 비동기 작업과 페이지네이션 결과 흐름을 따릅니다.

  1. 1. 입력 제출

    게시물 URL, 서브레딧 URL, 검색어를 알맞은 API에 보내고 반환된 task_id를 저장합니다.

  2. 2. 작업 추적

    처리가 완료될 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 결과 가져오기

    data.results.items를 읽고, has_more가 true인 동안 next_cursor를 사용합니다.

공개 Reddit 토론 검색

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 true

Reddit 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 크레딧입니다. 빈 결과에는 결과 요금이 부과되지 않습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.