reddit/
user-profile

사용자 이름으로 Reddit 계정을 한 번에 최대 100개까지 조회하며, 전체·게시물·댓글 카르마, 활동 수, 계정 생성일, 프로필 플래그를 반환합니다.

Reddit User Profile API

사용자 이름 입력
카르마 세부 구분
계정 나이
최대 100개 계정
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Reddit User Profile

Reddit 사용자 프로필은 u/ 이름 뒤에 있는 공개 계정 페이지로, 게시물과 댓글로 나뉜 전체 카르마, 작성한 게시물과 댓글 수, 계정 생성일, 소개, 아바타, 트로피, 인증 계정과 Reddit 직원 배지를 보여 줍니다. 이 신호를 함께 보면 계정이 얼마나 자리를 잡았고 얼마나 활발한지 알 수 있어, 크리에이터 검증, 신규 계정과 저카르마 계정 선별, 특정 분야 영향력 있는 멤버의 장기 추적에 쓸 수 있습니다.

Reddit User Profile API 주요 기능

  • 요청당 최대 100개 사용자 이름usernames 배열에는 u/ 접두사 유무와 관계없이 Reddit 이름을 최대 100개까지 넣을 수 있고, 존재하는 계정은 각각 별도 행으로 반환됩니다.
  • 출처별로 나뉜 카르마metrics.karma_count 값은 전체 카르마이고, post_karma_count와 comment_karma_count 값은 그 카르마가 게시물로 쌓였는지 댓글로 쌓였는지 보여 줍니다.
  • 활동 수와 계정 나이posts_count와 comments_count 값으로 계정이 얼마나 기여했는지 가늠하고, published_at 값에는 계정이 생성된 시점이 기록됩니다.
  • 프로필 배지와 트로피is_verified, is_employee, is_nsfw 값에 Reddit 자체 계정 플래그가 담기고 trophies_count 값은 트로피 수를 나타내며, 표시 이름, 소개, 아바타, 배너도 함께 제공됩니다.

Reddit User Profile API 매개변수

매개변수필수설명
usernames필수Reddit 사용자 이름을 최대 100개까지 넣으며 u/ 접두사는 붙여도 되고 빼도 됩니다. 각 이름은 영문자, 숫자, 하이픈, 밑줄로 된 3~20자입니다.

Reddit User Profile API 사용 방법

Reddit 사용자 이름 목록을 보내고, 존재하는 계정마다 프로필 행 하나를 읽습니다.

  1. {"usernames": ["spez", "GovSchwarzenegger"]}을 /v1/reddit/user-profile로 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-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["spez","GovSchwarzenegger"]}'

Reddit User Profile API 추천 활용 사례

  • 연락 전 크리에이터 검증: karma_count, posts_count, published_at 값을 보고 연락하려는 Redditor가 오래되고 활발한 이력을 가졌는지 확인합니다.
  • 신규·저카르마 계정 선별: 비슷한 게시물이나 댓글이 한꺼번에 올라왔을 때 작성자를 검토하면서, published_at 값이 최근이고 karma_count 값이 낮은 사용자 이름을 따로 표시합니다.
  • 관심 분야 계정 목록 추적: 같은 사용자 이름을 정기적으로 다시 조회해 karma_count, posts_count, followers_count 값을 비교하고 어떤 멤버가 성장하는지 파악합니다.
  • Reddit 핸들 목록 보강: 스레드에서 모은 사용자 이름에 표시 이름, 소개, avatar_url, 프로필 url 값을 더해 스프레드시트나 CRM에서 각 사람이 누구인지 바로 보이게 합니다.

Reddit User Profile API 활용 팁

  • 제출 전에 이름을 정리하세요. u/ 접두사를 뺀 각 이름은 영문자, 숫자, 하이픈, 밑줄로 된 3~20자여야 하며, 형식이 잘못된 항목이 하나라도 있으면 요청 전체가 거부됩니다.
  • 결과 행은 소문자로 바꾼 사용자 이름으로 입력값과 맞추세요. 대소문자만 다른 같은 이름을 두 번 제출하면 한 번만 조회되어 행도 하나만 반환됩니다.
  • 100개가 넘는 목록은 100개씩 나눠 제출하고, 계정의 영구 Reddit 식별자인 id 값으로 결과를 합치세요.

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

  • Reddit Posts API — 지원되는 Reddit URL에서 공개 게시물 텍스트, 작성자, 커뮤니티 맥락, 미디어, 타임스탬프, 공개된 참여도를 수집합니다.
  • Reddit Subreddit Details API
  • Reddit User Posts API — 사용자 이름 하나로 Reddit 사용자의 게시물 기록을 new, top, hot 순으로 수집하며 제목과 본문, 점수, 댓글 수, 미디어를 포함합니다.
  • Reddit User Comments API — 사용자 이름 하나로 Reddit 사용자의 댓글 기록을 수집하며 300자 발췌문, 점수, 댓글 링크, 게시물 ID를 포함합니다.
  • Reddit User Active Subreddits API — 사용자 이름 하나로 Reddit 사용자가 활동하는 서브레딧을 회원 수, 소개와 함께 나열합니다.
  • Reddit Subreddit Rules API — 서브레딧 URL로 번호가 매겨진 커뮤니티 규칙을 규칙별 짧은 제목, 전문과 함께 가져옵니다.

다른 플랫폼 둘러보기

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

Reddit User Profile API — 자주 묻는 질문

Reddit User Profile API는 사용자 이름으로 공개 Reddit 계정을 조회하는 프로그래밍 인터페이스입니다. 게시물과 댓글로 나뉜 카르마, 게시물·댓글 수, 계정 생성일, 프로필 정보, 계정 플래그를 반환합니다.

usernames 배열에 사용자 이름을 넣고 metrics.karma_count 값에서 전체 카르마를 읽으세요. post_karma_count와 comment_karma_count 값은 그 카르마가 어디서 쌓였는지 보여 줍니다.

published_at 값에 계정이 생성된 날짜와 시각이 ISO 8601 형식으로 담겨 있으므로, 오늘 날짜에서 빼면 계정 나이를 구할 수 있습니다.

반환된 계정 하나당 0.5 크레딧이므로, 계정 100개를 조회하면 50 크레딧입니다.