Threads profile API

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

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

계약 요약(영어): Get a normalized Threads profile (capability threads.profile)

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

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

활용 사례

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

응답 필드

Threads Profile (normalized)

Normalized Threads profile — the ONLY upper-layer format; provider-private fields are dropped by the Normalizer. Serves threads.profile and the user lists of /v1/threads.

필드	타입	필수	설명
id	string	필수	Platform-stable user id (username).
platform	"threads"	필수	—
type	"profile"	필수	—
username	string	필수	The platform addressing/display key without leading @.
display_name	string \| null	선택	The profile display name.
description	string \| null	선택	The profile bio.
url	string \| null	선택	The profile/bio link.
profile_image_url	string \| null	선택	Avatar media URL.
verified	boolean	필수	Platform verification flag.
created_at	string \| null	선택	Account creation time, UTC RFC3339; null when the provider does not expose it.
metrics.followers	integer	필수	Follower count.
metrics.following	integer	필수	Following count.
metrics.posts	integer	필수	Published post/message/work count.
fetched_at	string	필수	Normalization time of the stored snapshot (UTC).

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

응답 메타데이터

필드	타입	필수	설명
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/threads/users/{username}

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

{
  "data": {
    "id": "7455000122",
    "platform": "threads",
    "type": "profile",
    "username": "meshdata",
    "display_name": "MeshData Threads",
    "description": "Threads 数据开放。",
    "profile_image_url": "https://cdn.example.com/avatar/threads-meshdata.jpg",
    "verified": true,
    "created_at": "2021-07-06T00:00:00Z",
    "metrics": {
      "followers": 815000,
      "following": 310,
      "posts": 4200
    },
    "fetched_at": "2026-09-21T09:00:00Z"
  },
  "meta": {
    "request_id": "req_01HTXQ8Z9HTQ",
    "freshness": {
      "mode": "default",
      "age_seconds": 0,
      "source_layer": "upstream",
      "stale": false
    },
    "billing": {
      "amount_credits": 100,
      "cache_hit": false
    }
  }
}

무료 데모

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

Playground에서 사용해 보기

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

엔드포인트 레퍼런스 열기

자주 묻는 질문

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

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

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

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

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

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

가격

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

가격 보기 모든 API 둘러보기