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을 제출하고, 비동기 작업을 따라가며, 정규화된 댓글 레코드를 커서 페이지네이션으로 읽습니다.
- 지원되는 공개 Reddit 게시물 URL 또는 redd.it 단축 링크를 하나 이상 준비합니다.
- 링크를 urls로 /v1/reddit/comments에 제출하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 trueReddit 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로 계속 요청하세요.
관련 API
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를 포함합니다.