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 사용자 이름 목록을 보내고, 존재하는 계정마다 프로필 행 하나를 읽습니다.
- {"usernames": ["spez", "GovSchwarzenegger"]}을 /v1/reddit/user-profile로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- 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 값으로 결과를 합치세요.
관련 API
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로 번호가 매겨진 커뮤니티 규칙을 규칙별 짧은 제목, 전문과 함께 가져옵니다.