Reddit Posts
Reddit 게시물은 커뮤니티에 올라온 글로, 공개 페이지에서 제목, 본문, 작성자, 플레어, 미디어, 게시 시각, 공개된 투표 수와 댓글 수를 확인할 수 있습니다. 이 필드들을 서브레딧 및 수집 시각과 연결하면 개별 게시물을 출처 검토, 콘텐츠 분석, 시점별 비교에 활용할 수 있습니다.
Reddit Posts API 주요 기능
- 게시물 직접 조회허용되는 Reddit 토론 URL 또는 redd.it 단축 링크를 해당 공개 게시물의 정규화된 레코드로 변환하며, 서브레딧 홈 페이지와 관련 없는 경로는 거부합니다.
- 게시물 내용과 작성자게시물 ID, 공개 URL, 제목, 본문 텍스트, 확인 가능한 작성자 식별 정보를 반환하므로 각 항목의 출처를 추적할 수 있습니다.
- 서브레딧과 분류 정보원본에서 제공되는 경우 플레어와 함께 커뮤니티 이름, URL, 공개된 멤버 수를 extra 아래에 제공합니다.
- 미디어, 참여 지표, 수집 시각미디어 참조, created_at, collected_at, upvotes_count, comments_count, upvote_ratio를 시각이 기록된 하나의 스냅샷으로 묶어 보관합니다.
Reddit Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 지원되는 Reddit 호스트의 /r/{subreddit}/comments/{post_id} 경로를 사용하는 공개 Reddit 게시물 URL 또는 redd.it 단축 링크의 목록으로, 필수 값입니다. |
Reddit Posts API 사용 방법
필요한 공개 게시물을 정확히 지정해 제출하고, 비동기 작업을 따라가며, 정규화된 레코드를 커서 페이지네이션으로 읽습니다.
- 지원되는 comments 경로 또는 redd.it 단축 링크를 사용하는 공개 Reddit 게시물 URL을 하나 이상 준비합니다.
- 링크를 urls로 /v1/reddit/posts에 제출하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
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/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 Posts API 추천 활용 사례
- 출처 기반 게시물 검토: 게시물 ID, URL, 제목, 본문 텍스트, 작성자 필드를 보존해 검토자가 분석에 포함된 공개 게시물을 그대로 다시 확인할 수 있게 합니다.
- 커뮤니티 간 주제 비교: 제목과 본문 텍스트를 community_name과 tag별로 묶어, 정해 둔 주제가 선택한 서브레딧마다 어떻게 다뤄지는지 살펴봅니다.
- 시점별 참여 지표 추적: upvotes_count, comments_count, upvote_ratio를 collected_at과 함께 저장해, 값이 영구적이라고 가정하지 않고 반복 수집한 스냅샷끼리 비교합니다.
Reddit Posts API 활용 팁
- 단축 링크와 전체 토론 URL이 같은 게시물을 가리킬 수 있으므로, 일괄 제출 전에 redd.it 링크를 풀고 게시물 식별자 기준으로 중복을 제거하세요.
- 게시물 URL을 이미 알고 있을 때 이 엔드포인트를 사용하세요. 서브레딧 홈 페이지, 검색어, 정렬 옵션, results_limit은 받지 않습니다.
- 공개 원본에서 제공하지 않을 수 있으므로 작성자, 미디어, tag, 커뮤니티 정보, 타임스탬프, 지표가 null일 수 있다고 가정하세요.
- 공개된 참여 지표 옆에 collected_at을 저장해 두면, 이후 스냅샷의 관측 시각을 덮어쓰지 않고 비교할 수 있습니다.
관련 API
Reddit Posts API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Reddit Comments API — 지원되는 게시물 URL에서 공개 댓글 텍스트, 작성자, 게시물 및 상위 댓글 참조, 커뮤니티 맥락, 타임스탬프, 공개된 참여도를 수집합니다.
- Reddit Subreddit Posts API — 서브레딧 URL에서 new, top, hot 정렬로 공개 게시물을 찾으며, 서브레딧별 결과 수 제한과 정규화된 커뮤니티 및 참여도 맥락을 포함합니다.
- Reddit Search API — 텍스트 검색어와 게시 기간으로 공개 Reddit 게시물을 검색하고, 정규화된 콘텐츠, 작성자, 커뮤니티 맥락, 타임스탬프, 미디어, 공개된 참여도를 반환합니다.
- Reddit Subreddit Details API
- Reddit User Posts API — 사용자 이름 하나로 Reddit 사용자의 게시물 기록을 new, top, hot 순으로 수집하며 제목과 본문, 점수, 댓글 수, 미디어를 포함합니다.
- Reddit Popular Feed API — r/popular 게시물을 hot, best, new, rising, top 순으로 수집하며 제목과 본문, 작성자, 점수, 댓글 수, 미디어를 포함합니다.