Reddit profile API

REST 호출 한 번으로 Reddit profile 데이터를 조회 — 모든 플랫폼이 공유하는 안정적인 JSON 스키마로 정규화됩니다.

게시된 엔드포인트 1개
GET /v1/reddit/users/{username}

계약 요약(영어): Get a normalized Reddit profile (capability reddit.profile)

정규화된 응답 엔터티: reddit/profile
capability: reddit.profile

모든 응답에는 신선도(cache / default / live)와 과금 메타데이터도 포함됩니다.

활용 사례

최신 {{platform}} 프로필 데이터로 CRM·아웃리치 도구 보강 — 팔로워 수, 인증 상태, 소개가 구조화된 JSON으로.
캠페인 전 일관되고 조회 가능한 프로필 지표로 크리에이터·파트너 계정 검토.
동일 계정을 반복 조회해 정규화된 필드를 비교하고 프로필 변화를 추적합니다.

응답 필드

Reddit Profile (normalized)

Normalized Reddit user profile. This is the ONLY upper-layer format; provider-private fields MUST NOT appear — the Normalizer drops them. The capability id is reddit.profile (the /v1/reddit surface).

필드	타입	필수	설명
id	string	필수	Platform-stable user id (t2 base36 without prefix).
platform	"reddit"	필수	—
type	"profile"	필수	—
username	string	필수	The Reddit username (without u/).
display_name	string \| null	선택	The profile title.
description	string \| null	선택	The public profile description.
url	string \| null	선택	The profile URL.
profile_image_url	string \| null	선택	The profile icon.
verified	boolean	필수	—
created_at	string \| null	선택	Account creation time (created_utc, UTC epoch seconds upstream), RFC3339; null when not exposed.
metrics.karma_posts	integer	필수	Link (post) karma.
metrics.karma_comments	integer	필수	Comment karma.
metrics.total_karma	integer	필수	—
metrics.followers	integer	선택	Profile subscribers; omitted when unknown.
fetched_at	string	필수	When the platform data was actually collected (UTC RFC3339).

필드 비고는 계약 영문 원문으로 표시됩니다.

응답 메타데이터

필드	타입	필수	설명
mode	cache \| default \| live	필수	Effective mode after merging param > max_age > source policy (D-004).
age_seconds	integer \| null	선택	Age of served data; null when unknown.
source_layer	cache \| db \| upstream	필수	Which layer served the response (PRD §10).
stale	boolean	선택	True when stale data was served under stale_if_error / SWR (D-004).
billing.amount_credits	integer	필수	Micro-USD (1e-6 USD) actually charged for this request.
billing.cache_hit	boolean	필수	—

필드 비고는 계약 영문 원문으로 표시됩니다.

요청·응답 예시

GET/v1/reddit/users/{username}

curl -H "Authorization: Bearer $MESHDATA_API_KEY" \
  "https://api.fetchpi.com/v1/reddit/users/newdev"

{
  "data": {
    "id": "1a2b3c",
    "platform": "reddit",
    "type": "profile",
    "username": "creatordev",
    "display_name": "Creator Dev",
    "description": "Posts about data APIs.",
    "profile_image_url": "https://cdn.example.com/avatar/creatordev.png",
    "verified": true,
    "created_at": "2019-04-01T08:15:00Z",
    "metrics": {
      "karma_posts": 8620,
      "karma_comments": 15300,
      "total_karma": 24100,
      "followers": 4811
    },
    "fetched_at": "2026-09-18T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 120,
      "source_layer": "db",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

무료 데모

무료 계정을 만들고 API 키를 발급받으면 브라우저 Playground에서 바로 호출할 수 있습니다.

Playground에서 사용해 보기

이 엔드포인트의 파라미터 표, 오류 코드, 응답 의미는 API 문서에 있습니다.

엔드포인트 레퍼런스 열기

자주 묻는 질문

Reddit profile API는 무엇을 반환하나요?

정규화된 프로필 객체(신원·소개·오디언스 필드, 아래 필드 표 참조)와 신선도·과금 메타데이터를 반환합니다.

이 엔드포인트를 무료로 써볼 수 있나요?

네 — 계정을 등록하고 API 키를 발급받으면 콘솔의 Playground에서 호출할 수 있습니다.

profile 능력은 어떻게 과금되나요?

Data API는 요청 단위 크레딧 과금이며 cache/live 신선도에 따라 배율이 다릅니다. 현재 능력별 가격은 가격 페이지를 기준으로 합니다.

가격

요청 단위 크레딧 과금, cache/live 신선도 옵션 — 최신 가격은 가격 페이지 기준입니다.

가격 보기 모든 API 둘러보기