Reddit Subreddit Posts
서브레딧 게시물은 커뮤니티에 올라온 공개 글로, 제목, 본문, 작성자, 플레어, 미디어, 게시 시각, 공개된 투표 수와 댓글 수를 담고 있습니다. 이러한 콘텐츠, 맥락, 참여 지표 필드는 커뮤니티 모니터링, 주제 리서치, 서브레딧 목록 간 같은 조건의 비교에 활용할 수 있습니다.
Reddit Subreddit Posts API 주요 기능
- 서브레딧 목록 탐색허용되는 /r/{subreddit} URL에서 공개 게시물을 찾고, 요청에 포함된 모든 서브레딧에 적용할 new, top, hot 목록 중 하나를 선택합니다.
- 서브레딧별 수집 규모results_limit 값을 제출한 서브레딧 URL마다 따로 적용하며, 기본값은 100이고 1에서 2,000까지 사용할 수 있습니다.
- 정규화된 게시물 내용과 작성자게시물 식별자, 원본 URL, 제목, 본문 텍스트, 확인 가능한 작성자 필드, 미디어 참조를 일관된 레코드 형태로 반환합니다.
- 커뮤니티와 참여 지표 컨텍스트플레어, 커뮤니티 정보, 게시·수집 시각, upvotes_count, comments_count, upvote_ratio, discovery_input을 게시물마다 함께 보관합니다.
Reddit Subreddit Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 지원되는 Reddit 호스트에서 정확히 /r/{subreddit} 경로를 사용하는 공개 Reddit 서브레딧 URL의 목록으로, 필수 값입니다. |
results_limit | 선택 | 서브레딧 URL마다 요청할 최대 게시물 수입니다. 기본값은 100이며 1에서 2,000 사이의 정수를 사용할 수 있습니다. |
sort_by | 선택 | 제출한 모든 서브레딧 URL에 적용할 목록 종류입니다. 기본값은 new이며 new, top, hot을 지원합니다. |
Reddit Subreddit Posts API 사용 방법
공개 서브레딧 URL을 목록 모드 하나와 서브레딧별 결과 수 제한과 함께 제출하고, 비동기 작업 결과를 커서 페이지네이션으로 읽습니다.
- 경로가 /r/{subreddit}인 공개 Reddit URL을 하나 이상 준비합니다.
- urls, results_limit, sort_by를 /v1/reddit/subreddit-posts로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/learnpython/"],"results_limit":100,"sort_by":"new"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueReddit Subreddit Posts API 추천 활용 사례
- 커뮤니티 게시물 모니터링: new 목록을 수집하고 게시물 ID, created_at, collected_at, 제목, 텍스트를 보관해, 선택한 서브레딧에 최근 올라온 공개 글을 검토합니다.
- 서브레딧 주제 리서치: 제목, 본문 텍스트, 플레어, 커뮤니티 필드를 묶어 정해 둔 공개 커뮤니티 안에서 반복되는 주제와 형식을 살펴봅니다.
- 같은 조건의 목록 비교: 서브레딧 URL 전체에 같은 sort_by를 사용해, 하나의 목록 모드 아래에서 게시 시각, upvotes_count, comments_count, upvote_ratio를 비교합니다.
Reddit Subreddit Posts API 활용 팁
- 서브레딧 이름, 게시물 URL, 더 깊은 경로가 아니라 정식 /r/{subreddit} 홈 URL을 제출해야 URL 검증을 통과합니다.
- 제한과 크레딧 예상치는 서브레딧마다 따로 적용되므로, 요청 규모는 urls의 개수에 results_limit을 곱해 계산하세요.
- 요청 하나에서는 모든 서브레딧 URL에 sort_by 값이 하나만 적용되므로, new, top, hot을 비교하려면 작업을 따로 실행하세요.
- 하위 데이터셋에서 원본 서브레딧과 관측 시점을 알 수 있도록 레코드마다 discovery_input과 collected_at을 유지하세요.
- 공개 목록에서 제공되지 않을 수 있으므로 작성자, 미디어, 플레어, 커뮤니티, 타임스탬프, 참여 지표 필드는 null이거나 비어 있는 경우를 허용하세요.
관련 API
Reddit Subreddit Posts API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
- Reddit Comments API — 지원되는 게시물 URL에서 공개 댓글 텍스트, 작성자, 게시물 및 상위 댓글 참조, 커뮤니티 맥락, 타임스탬프, 공개된 참여도를 수집합니다.
- 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 순으로 수집하며 제목과 본문, 작성자, 점수, 댓글 수, 미디어를 포함합니다.