reddit/
user-posts

사용자 이름 하나로 Reddit 사용자가 올린 게시물을 new, top, hot 순으로 최대 1000개까지 수집하며, 제목과 본문 텍스트, 순 점수, 댓글 수, 미디어를 반환합니다.

Reddit User Posts API

사용자 이름 입력
new / top / hot 정렬
최대 1000개 게시물
점수와 댓글 수
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Reddit User Posts

Reddit 사용자의 게시물 기록은 한 계정이 여러 커뮤니티에 올린 글의 목록으로, 게시물마다 제목과 본문, 링크, 게시 시각, 순 점수, 댓글 수, 첨부 이미지나 동영상이 담겨 있습니다. 날짜순이나 점수순으로 읽으면 그 사람이 무엇을 공유하는지, 어떤 주제가 반응을 얻는지, 활동이 시간에 따라 어떻게 바뀌는지 드러나므로 크리에이터 리서치, 창업자 계정 모니터링, 전문가의 장문 글 수집에 활용할 수 있습니다.

Reddit User Posts API 주요 기능

  • 사용자 이름 하나로 최대 1000개 게시물username 값에는 u/ 접두사 유무와 관계없이 계정 하나를 넣고, results_limit 값으로 게시물을 1~1000개 수집하며 기본값은 25입니다.
  • 제목과 본문을 담은 하나의 text 필드text 값은 게시물 제목으로 시작하고, 셀프 게시물이라면 빈 줄 뒤에 본문 전체가 이어져 필드 하나에 글 전체가 담깁니다.
  • 순 점수와 댓글 수metrics.likes_count 값은 추천 수에서 비추천 수를 뺀 게시물 점수이고, metrics.comments_count 값은 게시물이 이끌어 낸 토론의 양을 보여 줍니다.
  • 이미지, 갤러리, 호스팅 동영상media 배열에는 첨부된 이미지와 동영상이 url, 미리보기 이미지, 픽셀 단위 너비와 높이와 함께 담겨 썸네일이나 다운로드에 바로 쓸 수 있습니다.

Reddit User Posts API 매개변수

매개변수필수설명
username필수Reddit 사용자 이름 하나로, u/ 접두사는 붙여도 되고 빼도 되며 영문자, 숫자, 하이픈, 밑줄로 된 3~20자입니다.
sort_by선택게시물 정렬 순서로 new(기본값), top, hot 중 하나입니다.
results_limit선택수집할 최대 게시물 수로 1~1000 사이 정수이며 기본값은 25입니다.

Reddit User Posts API 사용 방법

사용자 이름 하나와 정렬 순서, 수량 제한을 제출한 뒤 게시물을 페이지별로 읽습니다.

  1. {"username": "spez", "sort_by": "new", "results_limit": 25}을 /v1/reddit/user-posts로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. results.items에서 게시물을 읽고, has_more 값이 true인 동안 results.next_cursor를 넘겨 다음 페이지를 불러옵니다.
curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"spez","sort_by":"new","results_limit":25}'

Reddit User Posts API 추천 활용 사례

  • 계정의 최신 게시물 추적: sort_by 값을 new로 두고 정기적으로 실행해 published_at과 url 값을 읽으면 창업자, 기자, 경쟁사 계정의 새 게시물을 하나씩 잡아낼 수 있습니다.
  • 사용자의 고득점 게시물 순위 정리: sort_by 값을 top으로 요청하고 likes_count와 comments_count 값을 비교해 그 사람의 어떤 주제와 형식이 가장 큰 반응을 얻었는지 확인합니다.
  • 전문가 글로 코퍼스 구축: 셀프 게시물의 text 값을 url, published_at 값과 함께 저장해 한 전문가의 장문 설명을 모은 데이터셋을 만듭니다.

Reddit User Posts API 활용 팁

  • 첫 번째 빈 줄을 기준으로 text를 나누면 제목과 본문이 분리됩니다. 링크 게시물과 미디어 게시물에는 제목만 들어 있습니다.
  • sort_by new로 새 게시물을 확인할 때는 이미 저장한 id 값을 보관해 두고, 아는 id가 나타나면 페이지 읽기를 멈추세요.
  • 계정의 활동 전체가 필요하면 같은 사용자 이름을 Reddit User Comments API로도 수집하세요. 다른 사람의 스레드에 남긴 답글은 그쪽에서 반환됩니다.

Reddit User Posts API 외에 Reddit의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
  • Reddit Comments API — 지원되는 게시물 URL에서 공개 댓글 텍스트, 작성자, 게시물 및 상위 댓글 참조, 커뮤니티 맥락, 타임스탬프, 공개된 참여도를 수집합니다.
  • Reddit Subreddit Posts API — 서브레딧 URL에서 new, top, hot 정렬로 공개 게시물을 찾으며, 서브레딧별 결과 수 제한과 정규화된 커뮤니티 및 참여도 맥락을 포함합니다.
  • Reddit User Profile API — 사용자 이름으로 Reddit 계정을 조회하고 전체·게시물·댓글 카르마, 활동 수, 계정 나이, 프로필 플래그를 반환합니다.
  • Reddit User Active Subreddits API — 사용자 이름 하나로 Reddit 사용자가 활동하는 서브레딧을 회원 수, 소개와 함께 나열합니다.
  • Reddit Popular Feed API — r/popular 게시물을 hot, best, new, rising, top 순으로 수집하며 제목과 본문, 작성자, 점수, 댓글 수, 미디어를 포함합니다.

다른 플랫폼 둘러보기

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

Reddit User Posts API — 자주 묻는 질문

Reddit User Posts API는 사용자 이름을 입력받아 Reddit 계정이 올린 게시물을 수집하는 프로그래밍 인터페이스입니다. 게시물마다 제목과 본문 텍스트, 링크, 게시 시각, 점수, 댓글 수, 첨부 미디어를 반환합니다.

사용자 이름과 함께 sort_by 값을 new로, results_limit 값을 최대 1000으로 보낸 뒤 has_more 값이 false가 될 때까지 next_cursor로 결과를 넘기세요.

new는 최신 게시물부터 거슬러 올라가고, top은 점수순으로 정렬하며, hot은 프로필에 대한 Reddit의 hot 순위를 따릅니다. sort_by를 생략하면 new가 적용됩니다.

반환된 게시물 하나당 0.5 크레딧이므로 기본값 25개는 12.5 크레딧, 1000개는 500 크레딧입니다. 게시물 수가 results_limit보다 적은 계정은 실제로 반환된 게시물만큼만 청구됩니다.