reddit/
comments

게시물 URL에서 공개 Reddit 댓글을 수집하고, 텍스트, 작성자와 스레드 정보, 타임스탬프, 공개된 참여 지표를 정규화된 레코드로 반환합니다.

Reddit Comments API

게시물 URL 입력
스레드 참조
참여 지표 스냅샷
결과당 0.3 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Reddit Comments

Reddit 댓글은 게시물 토론 안에 달린 공개 답글로, 텍스트, 작성자 정보, 원본 게시물과 부모 댓글에 대한 참조, 커뮤니티 정보, 타임스탬프, 공개된 투표 수와 답글 수를 담고 있습니다. 이 필드들을 함께 보면 반응 분석, 답글 관계 파악, 출처가 연결된 아카이빙, 시점별 비교에 반환된 댓글을 활용할 수 있습니다.

Reddit Comments API 주요 기능

  • 지정한 토론의 댓글지원되는 Reddit 게시물 URL 또는 redd.it 단축 링크를 받아 해당 토론에서 제공되는 공개 댓글 레코드를 반환합니다.
  • 댓글 내용과 작성자확인 가능한 댓글 ID, 공개 URL, 텍스트, 작성자 식별 정보를 댓글마다 별도의 정규화된 레코드로 반환합니다.
  • 게시물·답글 참조post_id, post_url, parent_comment_id, community_name, input_url을 제공해 반환된 댓글을 원본 게시물 및 서로 연결할 수 있습니다.
  • 공개된 반응 스냅샷upvotes_count와 replies_count를 created_at, collected_at과 함께 보관해 게시 시각과 수집 시각을 구분합니다.

Reddit Comments API 매개변수

매개변수필수설명
urls필수지원되는 Reddit 호스트의 /r/{subreddit}/comments/{post_id} 경로를 사용하는 공개 Reddit 게시물 URL 또는 redd.it 단축 링크의 목록으로, 필수 값입니다.

Reddit Comments API 사용 방법

공개 Reddit 게시물 URL을 제출하고, 비동기 작업을 따라가며, 정규화된 댓글 레코드를 커서 페이지네이션으로 읽습니다.

  1. 지원되는 공개 Reddit 게시물 URL 또는 redd.it 단축 링크를 하나 이상 준비합니다.
  2. 링크를 urls로 /v1/reddit/comments에 제출하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
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/example/comments/post_id/example_post/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Reddit Comments API 추천 활용 사례

  • 정성적 반응 검토: 댓글 텍스트와 확인 가능한 작성자 필드를 분석해 선택한 토론 속 주장, 질문, 반복되는 반응을 파악합니다.
  • 반환된 답글 관계 파악: 댓글 ID와 parent_comment_id로 반환된 레코드에 포함된 답글끼리 연결합니다. 스레드 전체가 수집되었다고 가정하지는 않습니다.
  • 출처가 연결된 댓글 아카이빙: 댓글 URL, post_id, post_url, community_name, 타임스탬프를 보존해 저장한 모든 답글이 토론 맥락을 유지하도록 합니다.
  • 시점별 반응 비교: 반환된 댓글의 upvotes_count와 replies_count를 비교하되, 각 관측값을 collected_at에 맞춰 기록합니다.

Reddit Comments API 활용 팁

  • 같은 토론이 여러 URL 형태로 중복 제출되지 않도록, 일괄 제출 전에 redd.it 링크를 풀고 원본 게시물 기준으로 중복을 제거하세요.
  • results_limit은 보내지 마세요. 이 엔드포인트는 해당 값을 거부하며, 허용된 게시물 URL마다 반환된 댓글을 저장합니다.
  • parent_comment_id는 결과 집합에 실제로 있는 레코드를 연결하는 용도로만 사용하세요. 스레드 깊이가 완전하다는 것을 보장하지 않습니다.
  • 공개 원본에서 생략된 경우를 대비해 텍스트, 작성자 필드, parent_comment_id, community_name, 타임스탬프, 지표가 null일 수 있다고 가정하세요.
  • 완료된 작업의 댓글이 API 결과 페이지 경계에서 누락되지 않도록, has_more가 false가 될 때까지 next_cursor로 계속 요청하세요.

Reddit Comments API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
  • Reddit Subreddit Posts API — 서브레딧 URL에서 new, top, hot 정렬로 공개 게시물을 찾으며, 서브레딧별 결과 수 제한과 정규화된 커뮤니티 및 참여도 맥락을 포함합니다.
  • Reddit Search API — 텍스트 검색어와 게시 기간으로 공개 Reddit 게시물을 검색하고, 정규화된 콘텐츠, 작성자, 커뮤니티 맥락, 타임스탬프, 미디어, 공개된 참여도를 반환합니다.
  • Reddit Subreddit Details API
  • Reddit Subreddit Search API
  • Reddit User Comments API — 사용자 이름 하나로 Reddit 사용자의 댓글 기록을 수집하며 300자 발췌문, 점수, 댓글 링크, 게시물 ID를 포함합니다.

다른 플랫폼 둘러보기

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

Reddit Comments API — 자주 묻는 질문

Reddit Comments API는 지원되는 Reddit 게시물 URL에서 공개 댓글 레코드를 수집하고, 텍스트, 작성자 데이터, 원본 게시물·부모 댓글 참조, 타임스탬프, 공개된 반응 지표를 정규화해 반환합니다.

reddit.com, www.reddit.com, old.reddit.com, new.reddit.com 중 하나의 http 또는 https URL이며 경로가 /r/{subreddit}/comments/{post_id}로 시작해야 합니다. redd.it와 www.redd.it 단축 링크도 사용할 수 있습니다.

아니요. Reddit Comments API는 results_limit을 거부하며, 허용된 게시물 URL마다 반환된 댓글 레코드를 저장하고 실제 결과 수를 기준으로 과금합니다.

반환된 레코드에는 값이 있는 경우 post_id, post_url, parent_comment_id, community_name, input_url이 포함됩니다. 이 필드로 반환된 댓글을 서로 연결할 수 있지만, 스레드 깊이가 완전하다고 보장하지는 않습니다.

아니요. 댓글에는 맥락 파악을 위한 post_id와 post_url이 포함될 수 있지만, 원본 게시물의 제목과 본문은 정규화된 댓글 레코드에 들어 있지 않습니다.

반환된 댓글 레코드 1건마다 0.3 SocQ 크레딧이 차감됩니다. 결과가 비어 있으면 결과 요금이 청구되지 않습니다.