reddit/
subreddit-posts

서브레딧 URL에서 new, top, hot 정렬로 공개 Reddit 게시물을 찾아, 내용, 작성자, 커뮤니티 정보, 미디어, 공개된 참여 지표를 정규화된 레코드로 반환합니다.

Reddit Subreddit Posts API

서브레딧 URL 입력
new, top, hot 정렬
서브레딧별 결과 수 제한
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 목록 모드 하나와 서브레딧별 결과 수 제한과 함께 제출하고, 비동기 작업 결과를 커서 페이지네이션으로 읽습니다.

  1. 경로가 /r/{subreddit}인 공개 Reddit URL을 하나 이상 준비합니다.
  2. urls, results_limit, sort_by를 /v1/reddit/subreddit-posts로 POST하고, 반환된 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/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 true

Reddit 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이거나 비어 있는 경우를 허용하세요.

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 순으로 수집하며 제목과 본문, 작성자, 점수, 댓글 수, 미디어를 포함합니다.

다른 플랫폼 둘러보기

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

Reddit Subreddit Posts API — 자주 묻는 질문

Reddit Subreddit Posts API는 허용되는 서브레딧 URL에서 new, top, hot 정렬로 공개 게시물을 찾습니다. 정규화된 내용, 작성자, 커뮤니티 정보, 미디어, 타임스탬프, 공개된 참여 지표를 반환합니다.

지원되는 Reddit 호스트의 http 또는 https URL이며, 경로가 정확히 /r/{subreddit} 형태여야 합니다(끝의 슬래시는 있어도 됩니다). 서브레딧 이름, 게시물 URL, 더 깊은 경로는 허용되지 않습니다.

sort_by는 new, top, hot을 지원하며 기본값은 new입니다. top 목록에 쓸 기간 매개변수는 받지 않습니다.

results_limit의 기본값은 100이며 1에서 2,000 사이의 값을 사용할 수 있습니다. URL마다 따로 적용되므로 results_limit이 50인 URL 두 개는 최대 100개의 게시물을 요청합니다.

아니요. 게시물마다 comments_count는 포함될 수 있지만, 결과에는 댓글 텍스트나 댓글 작성자가 들어 있지 않습니다.

공개 목록에서 사용할 수 있는 값을 제공하지 않으면 작성자 정보, 미디어, 플레어, 커뮤니티 정보, 게시 시각, 참여 지표가 null이거나 비어 있을 수 있습니다.

반환된 게시물 레코드 1건마다 0.5 SocQ 크레딧이 차감됩니다. 요청 전 예상치는 urls의 개수에 results_limit을 곱해 계산하며, 결과가 비어 있으면 결과 요금이 청구되지 않습니다.