RedditReddit 사용자서브레딧 규칙트렌드API 가이드

Reddit 사용자 API: 프로필, 게시물·댓글 기록, 트렌드, 서브레딧 규칙

SocQ의 신규 Reddit 엔드포인트 7종을 소개합니다. 사용자 프로필, 게시물·댓글 기록, 활동 서브레딧, r/popular, 인기 검색어, 서브레딧 규칙의 요청 방법과 결과당 가격을 정리했습니다.

SocQ2026년 11월 19일 업데이트약 7분 소요

SocQ는 이미 Reddit 게시물, 댓글, 서브레딧 목록, 검색을 지원하고 있었습니다. 2026-11-17에는 다른 질문에 답하는 엔드포인트 7개가 추가되었습니다. 이 Reddit 사용자는 누구이며, 무엇을 올리고 말하며, 어디에서 활동하는가, 그리고 Reddit 전체에서 무엇이 화제이고 각 서브레딧이 무엇을 허용하는가입니다.

이 가이드에서는 새 엔드포인트별로 반환 데이터, 요청 형식, 가격, 적합한 사용 시점을 다룹니다. Reddit 공식 API, OAuth, 이전에 출시된 엔드포인트는 Reddit API 가이드와 Reddit 스크래퍼 API 비교를 참고하세요.

빠른 답변: 사용자 이름이나 서브레딧 URL을 넣거나 아무 입력 없이 Authorization: Bearer $SOCQ_API_KEY와 함께 7개의 POST /v1/reddit/... 엔드포인트 중 하나로 요청을 보내세요. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 다음 data.results.items를 읽습니다. 엔드포인트 5개는 결과 단위로 과금되며(0.3 또는 0.5크레딧), Active Subreddits와 Trending Searches는 호출당 0.5크레딧입니다. 1크레딧은 $0.005입니다.

새로운 Reddit 엔드포인트 7종

엔드포인트반환 데이터가격
User Profile카르마(게시물·댓글), 게시물·댓글 수, 계정 생성 기간, 소개, 아바타, 트로피, 인증·직원 플래그계정당 0.5크레딧($0.0025)
User Postsnew, top, hot 기준의 사용자 게시물과 전체 텍스트, 점수, 댓글, 미디어게시물당 0.5크레딧($0.0025)
User Comments사용자 댓글과 점수, 시각, 링크, 댓글이 달린 게시물댓글당 0.3크레딧($0.0015)
User Active Subreddits사용자가 활동하는 서브레딧과 회원 수, 설명호출당 0.5크레딧($0.0025)
Popular Feedbest, hot, new, top, rising 기준의 r/popular 게시물게시물당 0.5크레딧($0.0025)
Trending Searches오늘의 Reddit 인기 검색어 순위호출당 0.5크레딧($0.0025)
Subreddit Rules번호가 매겨진 규칙과 짧은 제목, 전체 텍스트서브레딧당 0.5크레딧($0.0025)

Reddit 사용자 조사하기

Reddit User Profile

Reddit User Profile API는 계정마다 한 행을 반환합니다. 게시물 카르마와 댓글 카르마로 나뉜 총 카르마, 계정이 작성한 게시물과 댓글 수, 생성 시점, 프로필 소개와 아바타, 트로피 수, 인증 계정 및 Reddit 직원 여부 플래그가 포함됩니다. 아웃리치 전에 크리에이터를 검증하거나, 스레드 작성자들이 얼마나 자리 잡은 계정인지 판단할 때 사용하세요.

curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["spez", "GovSchwarzenegger"]
  }'

사용자 이름은 u/ 접두사 유무와 관계없이 최대 100개까지 보낼 수 있습니다. User Profile 문서를 참고하세요.

Reddit User Posts

Reddit User Posts API는 사용자의 게시물 기록을 가져옵니다. 텍스트 게시물의 전체 본문, 게시물 링크, 점수, 댓글 수, 게시 시각, 이미지나 동영상이 포함됩니다. 지금 무엇을 공유하는지 따라가려면 new로, 어떤 게시물이 가장 반응이 좋았는지 보려면 top으로 정렬하세요.

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
  }'

sort_by는 new(기본값), top, hot 중 하나입니다. results_limit의 기본값은 25이며 1부터 1,000까지 받습니다. likes_count에는 게시물 점수가 들어 있습니다. User Posts 문서를 참고하세요.

Reddit User Comments

댓글 기록은 본인이 올린 게시물보다 그 사람이 무엇을 알고 무엇에 관심이 있는지를 더 잘 보여 줍니다. Reddit User Comments API는 각 댓글을 점수, 시각, 댓글 링크, 댓글이 달린 게시물의 post_id와 함께 반환합니다. 전문가와 잠재 고객을 선별하거나, 특정 계정이 내 제품을 어떻게 이야기하는지 추적할 때 사용하세요.

curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "spez",
    "sort_by": "top",
    "results_limit": 100
  }'

results_limit의 기본값은 100이며 1부터 1,000까지 받습니다. text에는 최대 300자의 미리보기가 들어 있고, url을 열면 전체 댓글을 볼 수 있습니다. User Comments 문서를 참고하세요.

Reddit User Active Subreddits

Reddit User Active Subreddits API는 사용자가 최근 게시물이나 댓글을 남긴 커뮤니티를 회원 수, 설명과 함께 나열합니다. 한 사람의 관심사를 파악하고, 내 오디언스가 이용하는 니치 커뮤니티를 찾는 데 도움이 됩니다.

curl -X POST "https://api.socq.ai/v1/reddit/user-active-subreddits" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "GovSchwarzenegger"
  }'

요청 1회에 0.5크레딧이 들며, 해당 계정의 공개 활동 목록에 있는 커뮤니티를 모두 반환합니다. Active Subreddits 문서를 참고하세요.

Reddit에서 화제인 콘텐츠 살펴보기

Reddit Popular Feed API는 Reddit이 보여 주는 그대로 r/popular를 읽습니다. 모든 커뮤니티에서 떠오르는 게시물이 제목과 본문, 링크, 작성자, 점수, 댓글 수, 미디어와 함께 반환됩니다. sort_by를 top으로 바꾸고 published_within을 설정하면 하루나 일주일 동안 크게 주목받은 게시물을 볼 수 있습니다.

curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sort_by": "hot",
    "results_limit": 25
  }'

모든 필드는 선택 사항입니다. sort_by는 best, hot(기본값), new, top, rising 중 하나이며, published_within은 top에 적용되고 hour부터 all까지 지정할 수 있습니다. results_limit의 기본값은 25이며 1부터 500까지 받습니다. Popular Feed 문서를 참고하세요.

Reddit Trending Searches API는 오늘의 인기 검색어를 Reddit이 나열한 순서대로 반환합니다. 진행 중인 뉴스, 제품 출시, 문화적 이슈가 자주 등장합니다. 트렌드 대시보드용으로 하루에 몇 번 폴링하고, 관심 있는 주제는 Reddit Search로 깊이 파고드세요.

curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

입력은 필요하지 않습니다. 호출할 때마다 현재 목록을 반환하며, 보통 검색어 6개가 1위부터 순위가 매겨져 있습니다. Trending Searches 문서를 참고하세요.

게시하기 전에 서브레딧 규칙 확인하기

Reddit Subreddit Rules API는 서브레딧마다 한 행을 반환하며, 번호가 매겨진 규칙이 순서대로 들어 있습니다. 각 규칙에는 운영자가 신고 메뉴에 표시하는 짧은 제목과 규칙 전문이 포함됩니다. 브랜드는 출시 게시물을 올리기 전에 무엇이 허용되는지 확인하는 데 쓰고, 여러 계정을 운영하는 팀은 커뮤니티별 규칙집을 관리하는 데 씁니다.

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.reddit.com/r/AskReddit/"]
  }'

Subreddit Rules 문서를 참고하세요.

인증과 비동기 작업 흐름

모든 요청에는 API 키와 JSON 콘텐츠 유형이 포함됩니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

제출 호출마다 백그라운드 작업이 시작됩니다(submit -> task_id -> queued -> running -> succeeded, 또는 failed). 제출 응답은 data.task_id와 data.status를 반환합니다. 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

작업이 queued, running, failed 상태인 동안에는 응답에 작업 메타데이터만 들어 있으며, failed이면 error_message를 확인하세요. succeeded가 되면 응답의 data.results.items에 정규화된 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500까지 지정할 수 있습니다. has_more가 true이면 results.next_cursor를 cursor로 넘기세요. fields에는 쉼표로 구분한 필드나 점 경로를 최대 50개까지 지정할 수 있습니다.

클라이언트 쪽 타임아웃은 작업을 취소하지 않습니다. 중복 비용을 내지 말고 같은 task_id로 조회를 이어가세요. 제출 본문에 callback_url을 추가하면 작업이 끝났을 때 작업 요약을 담은 POST를 한 번 받을 수도 있습니다.

일반적인 작업 비용

  • 스레드 작성자 100명 프로필 조회: 100 × 0.5 = 50크레딧, $0.25.
  • 사용자 한 명 전체 조회(게시물 25개, 댓글 100개, 활동 서브레딧): 12.5 + 30 + 0.5 = 43크레딧, $0.215.
  • 30일 동안 하루 4번 인기 검색어 조회: 120 × 0.5 = 60크레딧, $0.30.

자주 묻는 질문(FAQ)

여러 Reddit 사용자를 한 번에 조회할 수 있나요?

User Profile은 요청당 최대 100개의 사용자 이름을 받습니다. User Posts, User Comments, Active Subreddits는 username을 하나씩만 받으므로 사용자마다 작업을 하나씩 제출하세요.

User Comments는 댓글 전문을 반환하나요?

text에는 최대 300자의 미리보기가 들어 있습니다. url 필드로 전체 댓글을 열 수 있고, post_id로 댓글이 달린 게시물을 식별합니다.

Popular Feed는 모든 커뮤니티에서 떠오르는 게시물이 섞인 r/popular를 읽습니다. 커뮤니티 하나를 읽으려면 Subreddit Posts를 사용하세요.

게시물이 없는 사용자도 비용이 드나요?

결과 단위 엔드포인트에는 기본 요금이 없으므로 결과가 비어 있으면 비용이 들지 않습니다. Active Subreddits와 Trending Searches는 호출당 0.5크레딧의 고정 요금입니다.

Reddit 데이터 제공업체는 어디에서 비교하나요?

Reddit API 대안을 참고하세요. 모든 SocQ Reddit 엔드포인트는 Reddit 플랫폼 페이지에, 현재 요금은 요금 페이지에 있습니다.

REDDIT API

공개 Reddit URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

Reddit API 살펴보기