API 목록으로 돌아가기
크리에이터 링크인바이오 페이지

Link in Bio 데이터 API

크리에이터가 Instagram, TikTok, YouTube 소개란에 넣는 링크 하나를 표시 이름, 소개, 프로필 사진, 공개된 연락처 이메일, 연결된 SNS 프로필, 각 버튼의 제목과 연결 주소라는 구조화된 데이터로 바꿉니다.

사용할 수 있는 Link in Bio API

Link in Bio API로 Linktree, Komi, lnk.bio, Link.me 페이지를 요청 하나에 최대 50개까지, 서비스를 자유롭게 섞어 읽을 수 있습니다.

어떤 링크인바이오 데이터를 가져올 수 있나요?

찾은 페이지마다 정규화된 한 행이 반환되며, 페이지에 표시되지 않은 값은 null로 남습니다.

페이지 식별 정보

읽은 페이지마다 서비스, 페이지 이름, 페이지 URL, linktree:miguelangeles 같은 id를 보관합니다.

크리에이터 프로필

표시 이름, 소개, 프로필 사진, 해당 서비스의 인증 배지를 읽습니다.

연락처 이메일

크리에이터가 페이지에 올린 연락처 주소를 가져와 아웃리치 레코드에 바로 활용합니다.

연결된 SNS 프로필

페이지 아이콘에 연결된 SNS 프로필과 웹사이트를 모읍니다.

페이지의 모든 링크

각 버튼을 표시 순서대로 제목, 연결 주소, 링크 유형, 썸네일과 함께 받고 전체 링크 수도 확인합니다.

SocQ와 페이지 직접 처리 비교

SocQ는 네 가지 링크인바이오 서비스를 하나의 요청 형식과 하나의 정규화된 행으로 읽습니다. 페이지를 직접 처리하면 수집, 서비스별 파싱, 저장, 스키마 유지 관리를 애플리케이션이 모두 맡아야 합니다.

기능SocQ페이지 직접 처리
시작 입력Linktree, Komi, lnk.bio, Link.me 페이지 URL을 목록 하나에 최대 50개페이지 URL과 서비스마다 작성한 수집 로직
결과 형식페이지마다 한 행, 모든 서비스에서 같은 필드서비스별 마크업과 자체 파싱
실행 방식상태를 폴링하는 비동기 작업애플리케이션이 직접 정의하고 운영
요금찾은 페이지당 0.5 크레딧자체 인프라와 유지 관리

Link in Bio API 작동 방식

이 엔드포인트는 SocQ 공통 비동기 작업과 저장된 결과 흐름을 따릅니다.

  1. 1. 페이지 URL 제출

    링크인바이오 URL을 최대 50개까지 urls에 넣어 /v1/link-in-bio/profile에 POST하고 task_id를 저장합니다.

  2. 2. 작업 추적

    작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 페이지별 행 읽기

    data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라갑니다.

링크인바이오 페이지 일괄 읽기

SocQ API 키로 인증하고 크리에이터 소개란에서 모은 페이지를 보냅니다. 찾은 페이지마다 0.5 크레딧이 부과됩니다.

curl -X POST "https://api.socq.ai/v1/link-in-bio/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://linktr.ee/miguelangeles","https://kimkardashian.komi.io","https://lnk.bio/msjennafischer","https://link.me/danucd"]}'

# Poll GET /v1/tasks/{task_id}
# Read one row per page in data.results.items

Link in Bio API 주요 활용 사례

크리에이터 연락처 보강

각 크리에이터의 소개란 링크에서 이메일, 표시 이름, 프로필 사진을 가져와 아웃리치 명단에 추가합니다.

채널 간 연결 정리

social_urls와 links로 크리에이터의 YouTube, Spotify, 쇼핑몰, 뉴스레터 경로를 연결합니다.

홍보 링크 추적

같은 페이지를 주기적으로 다시 읽고 링크를 비교해 새 스폰서, 제휴 쇼핑몰, 신제품 홍보를 찾아냅니다.

제한 사항과 공개 데이터 정책

Link in Bio 결과는 크리에이터가 직접 공개한 페이지를 특정 시점에 읽은 기록입니다.

  • 요청마다 linktr.ee/<name>, <name>.komi.io, lnk.bio/<name>, link.me/<name> 형식의 URL을 최대 50개까지 받습니다.
  • 더 이상 열리지 않는 페이지는 요금 없이 건너뛰며, 보낸 페이지를 하나도 읽지 못한 경우에만 작업이 실패하고 전액 환불됩니다.
  • email에는 크리에이터가 페이지에 올린 연락처 주소가 담기며, 다른 프로필 필드도 페이지에 표시된 내용을 따릅니다.

Link in Bio API 자주 묻는 질문

Link in Bio API란 무엇인가요?

크리에이터의 링크인바이오 페이지를 한꺼번에 읽어 각 페이지의 소개, 프로필 사진, 연락처 이메일, 연결된 SNS 프로필, 모든 링크를 정규화된 한 행으로 돌려주는 API입니다.

어떤 링크인바이오 서비스를 지원하나요?

Linktree, Komi, lnk.bio, Link.me를 지원하며 네 서비스를 한 요청에 섞어 보낼 수 있습니다.

크리에이터 이메일도 받을 수 있나요?

네. 크리에이터가 페이지에 연락처를 올려 두었다면 email에 담깁니다.

Link in Bio API 요금은 어떻게 되나요?

찾은 페이지마다 한 행이 반환되고 0.5 크레딧이 들며, 50개를 모두 찾으면 총 25 크레딧입니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.