reddit/
posts

지원되는 게시물 URL에서 공개 Reddit 게시물을 수집하고, 제목, 본문, 작성자, 커뮤니티 정보, 미디어, 타임스탬프, 공개된 참여 지표를 정규화된 레코드로 반환합니다.

Reddit Posts API

게시물 URL 입력
커뮤니티 정보
참여 지표 스냅샷
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

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

  1. 지원되는 comments 경로 또는 redd.it 단축 링크를 사용하는 공개 Reddit 게시물 URL을 하나 이상 준비합니다.
  2. 링크를 urls로 /v1/reddit/posts에 제출하고, 반환된 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/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 true

Reddit 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을 저장해 두면, 이후 스냅샷의 관측 시각을 덮어쓰지 않고 비교할 수 있습니다.

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

다른 플랫폼 둘러보기

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

Reddit Posts API — 자주 묻는 질문

Reddit Posts 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 Posts API는 urls에 지정한 개별 게시물 URL만 조회하며, 게시물 탐색용 서브레딧 홈 페이지, 키워드, 정렬 옵션은 받지 않습니다.

아니요. 이 엔드포인트는 urls만 받습니다. 입력 하나가 게시물 목록이 아니라 특정 게시물 하나를 가리키므로 제한할 대상이 없기 때문입니다.

아니요. 게시물 레코드에는 공개된 comments_count가 포함될 수 있지만, 댓글 텍스트나 댓글 작성자는 들어 있지 않습니다.

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

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