Linktree API

공개 Linktree 데이터 API

Name: Linktree Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 공개 Linktree 페이지 데이터를 구조화 JSON으로 가져옵니다. Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기 동작 방식 직접 호출

/v1/linktree

활성 엔드포인트는 1개입니다. 페이지는 Author 형태입니다.

GET /v1/linktree/page

Linktree 엔드포인트

공개 linktr.ee 페이지 읽기 엔드포인트는 1개입니다. 표시 이름, 소개글, 아바타, 그리고 호스트가 공개하는 링크 목록을 반환합니다. 데이터 API만 지원하며 페이지 편집과 비공개 대시보드는 포함되지 않습니다.

Linktree 페이지

1 크레딧

/v1/linktree/page

전체 linktr.ee URL로 공개 페이지를 가져옵니다. Author 정체성(username, 표시 이름, 소개글, 아바타)과 링크 목록을 author._links로 반환합니다. 각 링크는 id, type, title, url을 가집니다. 이 표면에는 팔로워 집계가 없습니다.

url

Linktree API1개 엔드포인트 지원

문서 보기

Linktree 페이지의 표시 이름과 소개글, 아바타, 그리고 페이지에 걸린 링크를 제목과 목적지 URL까지 전부 돌려줍니다.

linktr.ee 페이지를 읽을 때 사용하세요. lnk.bio와 Linkme, Komi, Pillar는 각각 별도 엔드포인트를 쓰세요.

1크레딧

GET/v1/linktree/page?url=https%3A%2F%2Flinktr.ee%2Fcharlidamelio

url

url · Full URL of the Linktree page

$ curl https://www.socialcrawl.dev/v1/linktree/page?url=https%3A%2F%2Flinktr.ee%2Fcharlidamelio \
    -H "x-api-key: sc_YOUR_API_KEY"

대기 중

// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Linktree API 동작

Linktree도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/linktree/page를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. Linktree OAuth와 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. Linktree 로그인 쿠키와 파트너 포털은 필요 없습니다. TikTok, Instagram, Reddit을 포함한 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 페이지 URL

공개 linktr.ee URL을 url 쿼리 파라미터로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

표준 읽기는 1 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지는 정규 Author 객체로 반환됩니다.

연동 순서

대부분 제품은 공개 페이지 URL 하나를 확인한 뒤 Author 카드와 링크 목록을 저장하거나 비교합니다.

01페이지

GET /v1/linktree/page?url=https://linktr.ee/…

Author 형태 페이지입니다. username, bio, avatar, _links[]가 포함됩니다.

URL 하나로 구조화 페이지 카드를 받습니다. 호스트 HTML 파싱이 필요 없습니다.

요청

GET /v1/linktree/page
  ?url=https://linktr.ee/charlidamelio
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

응답 봉투

{
  "success": true,
  "data": {
    "id": "2323354",
    "username": "example",
    "display_name": "example",
    "avatar_url": null,
    "bio": null,
    "url": "https://linktr.ee/example",
    "_links": [
      {
        "id": 1,
        "type": "CLASSIC",
        "title": "Latest drop",
        "url": "https://example.com/drop"
      }
    ]
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다. 다른 Author 카드를 파싱하면 이 응답도 같습니다.

Authorpage

id, username, display_name, avatar_url, bio, url, _links[] (id, type, title, url)

게이트웨이

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. 링크 인 바이오 전용 사이드카가 아닙니다.

엣지 수신

Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.

검증 후 차감

레지스트리에서 linktree/page를 찾습니다. url 형식 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 1 크레딧을 원자적으로 차감합니다.

캐시 또는 조회

platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 공개 페이지를 실시간으로 읽습니다. 5xx와 네트워크 오류는 재시도하며 불건전 시 서킷 브레이커가 동작합니다.

정규화 후 반환

업스트림 JSON을 Author로 매핑합니다. 공개 링크 배열이 있으면 _links로 붙입니다. Zod로 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.

과금 규칙

표준 라이브 미스는 1 크레딧입니다.
캐시 히트는 0 크레딧입니다.
빈 응답과 하드 실패는 자동 환불됩니다.
잘못된 파라미터는 400이며 과금하지 않습니다.
잔액이 없으면 402이며 과금하지 않습니다.
공개 페이지만 지원합니다.
쓰기와 편집 라우트는 없습니다.
카탈로그와 같은 API 키를 사용합니다.
분당 한도와 동시성 제한이 동일하게 적용됩니다.

데이터 수집

Linktree는 공개 읽기 크리에이터 페이지 데이터입니다. SocialCrawl Author 스키마로 정규화하므로 호스트별 레이아웃을 코드에 넣을 필요가 없습니다.

API에서의 Linktree

linktr.ee 공개 크리에이터 랜딩 페이지를 읽기 전용으로 제공합니다. 리서치, 모니터링, 제품 작업에 사용합니다. 페이지 편집, 분석 로그인, 비공개 대시보드 접근은 없습니다.

업스트림

GET /v1/linktree/page는 전달한 공개 페이지 URL을 요청 시점에 실시간으로 읽고 페이로드를 정규화합니다.

응답 형태

success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 페이지는 Author로, 링크 행은 author._links로 정규화됩니다.

미제공 항목

쓰기 엔드포인트는 없습니다. 비공개 분석과 클릭 대시보드는 없습니다. Linktree가 공개 페이지에 노출하지 않는 팔로워·인증 필드는 보장하지 않습니다.

필드 매핑

username, description, profilePictureUrl→ author.username, bio, avatar_url별도 표시 이름이 없으면 username이 표시 정체성이 됩니다.

links[] { id, type, title, url }→ author._linkslinks는 author._links로 들어가며 CLASSIC, MUSIC, VIDEO, COMMERCE 유형이 있습니다.

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

1active Linktree endpoints in the registry

1라이브 페이지 읽기당 크레딧

크리에이터 링크 스택 모니터링과 경쟁 바이오 감사

호출은 페이지 URL 하나에 집중됩니다. 크리에이터 카드를 확인한 뒤 링크 목록을 저장하거나 비교합니다. 공개 Linktree 페이지를 Author JSON으로 1 크레딧에 반환합니다. 카탈로그와 같은 키와 봉투를 사용합니다. Linktree OAuth는 필요 없습니다.

페이지 읽기는 라이브 미스 시 보통 수 초입니다. 캐시 히트는 즉시 반환됩니다.

Linktree API 활용 사례

Linktree 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

인플루언서 검색링크 인 바이오 페이지를 크리에이터의 나머지 핸들로 확장합니다.

계정 통합 조회크리에이터가 자기 계정을 직접 나열한 링크 페이지입니다. 페이지가 응답하면 보조 근거로 사용합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

크리에이터 운영 모니터

Python, cron, 스프레드시트

고정 linktr.ee URL을 폴링하고 제목이나 목적지가 바뀌면 알립니다. 라우트는 page 하나입니다.

경쟁 인텔 팀

Node, 노트북, BI 적재

경쟁 링크 스택을 Author 카드로 저장하고 드롭, 샵, 제휴 목적지 변화를 추적합니다.

백엔드 제품 잡

Go, 워커, Explorer

크리에이터 프로필에 공개 바이오 링크 카드를 붙입니다. 캐시 히트로 반복 비용을 낮춥니다. 카탈로그와 같은 API 키를 사용합니다.

호출 예시

표준 티어는 라이브 호출당 1 크레딧입니다. 캐시 히트는 무료입니다.

curl "https://www.socialcrawl.dev/v1/linktree/page?url=https://linktr.ee/charlidamelio" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl Linktree

카탈로그와 같은 API 키

플랫폼 문서 API 키 받기

엔드포인트

Linktree API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

PageGet Linktree page

비교

SocialCrawl과 직접 스크래핑, 뭐가 다른가요?

같은 Linktree 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

항목	SocialCrawl	직접 스크래핑
시작하기	API 키 하나로 GET 요청 한 번이면 바로 페이지 데이터를 받아요	헤드리스 브라우저, 프록시, HTML 파서를 직접 구축해야 해요
인증	x-api-key 헤더 하나로 51개 플랫폼을 모두 써요	관리할 키는 없지만 IP 차단과 봇 감지는 직접 감당해야 해요
응답 스키마	51개 플랫폼과 공유하는 통합 JSON, 링크·바이오·아바타가 안정된 필드로 와요	Linktree 디자인이 바뀔 때마다 형태가 달라지는 원본 HTML
요금	페이지당 1 크레딧, 가입 시 100 크레딧 무료(신용카드 불필요)	프록시·서버 비용에 개발 시간까지 더해져 예측이 어려워요
유지보수	업스트림 변경은 SocialCrawl이 흡수하고 스키마는 그대로 유지돼요	UI가 업데이트될 때마다 파서가 조용히 깨져요

시작하기

SocialCrawl

API 키 하나로 GET 요청 한 번이면 바로 페이지 데이터를 받아요

직접 스크래핑

헤드리스 브라우저, 프록시, HTML 파서를 직접 구축해야 해요

인증

SocialCrawl

x-api-key 헤더 하나로 51개 플랫폼을 모두 써요

직접 스크래핑

관리할 키는 없지만 IP 차단과 봇 감지는 직접 감당해야 해요

응답 스키마

SocialCrawl

51개 플랫폼과 공유하는 통합 JSON, 링크·바이오·아바타가 안정된 필드로 와요

직접 스크래핑

Linktree 디자인이 바뀔 때마다 형태가 달라지는 원본 HTML

요금

SocialCrawl

페이지당 1 크레딧, 가입 시 100 크레딧 무료(신용카드 불필요)

직접 스크래핑

프록시·서버 비용에 개발 시간까지 더해져 예측이 어려워요

유지보수

SocialCrawl

업스트림 변경은 SocialCrawl이 흡수하고 스키마는 그대로 유지돼요

직접 스크래핑

UI가 업데이트될 때마다 파서가 조용히 깨져요

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

Linktree 페이지 데이터는 어떻게 수집하나요?

linktr.ee URL을 url 파라미터에 담아 GET /v1/linktree/page를 호출하면 돼요. SocialCrawl이 크리에이터 표시 이름, 바이오, 아바타, 그리고 페이지에 등록된 모든 링크의 제목과 주소까지 JSON으로 정리해 응답해 드려요.

Linktree API는 어떤 데이터를 응답해 주나요?

표시 이름, 바이오 텍스트, 아바타 이미지 URL, 그리고 페이지의 전체 링크 목록을 받아볼 수 있어요. 각 링크에는 제목, 이동 주소, 그리고 Linktree가 노출하는 추가 정보(영상 임베드, 음원 미리듣기, 상품 카드, 소셜 아이콘)까지 담겨 있어요.

Linktree API는 요금이 얼마인가요?

한 번 요청에 1 크레딧이 소진돼요(스탠다드 티어). 새 계정에는 100 크레딧이 무료로 제공돼서 신용카드 없이 약 100개의 Linktree 페이지를 받아볼 수 있어요.

Linktree 데이터를 수집하는 게 법적으로 괜찮나요?

SocialCrawl은 Linktree 페이지의 공개 정보만 가져와요. linktr.ee URL을 열면 누구나 볼 수 있는 내용이지만, 사용 목적이 Linktree 약관과 개인정보 관련 법령에 부합하는지 직접 확인해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.

프로덕션에서도 Linktree API를 써도 되나요?

네, 안정적인 응답 속도와 업스트림 자동 재시도, 그리고 Linktree UI가 바뀌어도 깨지지 않는 통합 스키마를 제공해요. 안심하고 프로덕션에 붙이실 수 있어요.

Linktree 스크래퍼 API는 어떤 게 제일 좋나요?

파서를 직접 만들고 유지하기 부담스럽다면 SocialCrawl이 좋은 선택이에요. GET /v1/linktree/page 한 번이면 이름, 바이오, 아바타, 모든 링크가 정리된 JSON으로 오고 요청당 1 크레딧이에요. 다른 50개 플랫폼과 같은 키·통합 스키마를 쓰고, 가입하면 신용카드 없이 100 크레딧을 무료로 받아요.

Linktree 스크래핑 API와 공식 Linktree API는 뭐가 다른가요?

SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Linktree 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

Linktree API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요