Link in BioLinktree크리에이터 데이터인플루언서 아웃리치API 가이드

Link in Bio API: Linktree, Komi, lnk.bio, Link.me 페이지 대량 수집하기

요청 한 번에 Linktree, Komi, lnk.bio, Link.me 페이지를 최대 50개까지 읽어 소개글, 아바타, 연락처 이메일, 연결된 소셜 계정, 페이지의 모든 링크를 페이지당 0.5 크레딧에 가져올 수 있습니다.

SocQ2026년 11월 19일 업데이트약 6분 소요

크리에이터의 프로필 소개에 있는 링크는 보통 Linktree, Komi, lnk.bio, Link.me 페이지로 이어집니다. 크리에이터는 이 페이지에 연락처 이메일, 다른 소셜 계정, 쇼핑몰, 최신 동영상, 스폰서를 올려 둡니다. 크리에이터를 대규모로 리서치한다면 이 페이지들은 유용한 데이터이지만, 일일이 손으로 읽기에는 번거롭습니다.

2026-11-17에 SocQ는 새로운 Link in Bio 플랫폼에서 Link in Bio API를 출시했습니다. 네 서비스 전체에 걸쳐 요청당 최대 50개 페이지를 읽고, 각 페이지를 구조화된 레코드로 반환합니다. 이 가이드에서는 요청 방법, 필드, 가격, 그리고 아웃리치 파이프라인에서 활용하는 방법을 다룹니다.

빠른 답변: 페이지 URL을 최대 50개까지 urls에 담아 POST /v1/link-in-bio/profile로 보내세요. Linktree, Komi, lnk.bio, Link.me URL을 한 요청에 섞어 보낼 수 있습니다. GET /v1/tasks/{task_id}를 폴링해 data.results.items에서 페이지당 한 행씩 읽으면 됩니다. 찾은 페이지 하나당 비용은 0.5 크레딧($0.0025)입니다.

엔드포인트 반환 내용

1 SocQ 크레딧 = $0.005입니다.

엔드포인트반환 내용가격
Link in Bio API페이지당 한 행: 서비스, 페이지 이름, 표시 이름, 소개글, 아바타, 인증 배지, 연락처 이메일, 연결된 소셜 프로필, 그리고 제목·목적지·유형·썸네일이 포함된 페이지의 모든 링크찾은 페이지당 0.5 크레딧($0.0025)

더 이상 존재하지 않는 페이지는 건너뜁니다. 작업은 어떤 페이지도 읽을 수 없을 때만 실패 처리되고 환불됩니다.

인증과 비동기 작업 흐름

모든 SocQ 요청은 API 키로 인증하며, 작업 제출, 작업 상태 조회, 결과 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 응답에는 data.task_id와 data.status가 들어 있습니다. 이 ID로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded이면 응답의 data.results.items에 정규화된 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500까지 지정할 수 있으며, has_more가 true이면 results.next_cursor를 cursor로 넘겨 다음 페이지를 읽으세요. 작업이 queued, running, failed 상태인 동안에는 results 없이 작업 메타데이터만 반환됩니다.

제출 본문에 선택 항목인 callback_url을 넣으면 작업이 끝났을 때 SocQ가 작업 요약을 담은 POST를 한 번 보내며, 레코드는 GET /v1/tasks/{task_id}로 읽으면 됩니다. 클라이언트 측 타임아웃이 발생해도 작업은 취소되지 않으므로, 중복 비용을 내지 말고 같은 작업 ID로 조회를 이어가세요. 402는 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

링크 인 바이오 페이지 요청하기

urls에 페이지 URL을 최대 50개까지 linktr.ee/name, name.komi.io, lnk.bio/name, link.me/name 형식으로 넣으세요. Instagram이나 TikTok 프로필 소개에서 수집한 여러 서비스가 섞인 목록도 미리 분류할 필요가 없습니다.

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"
    ]
  }'

과금은 반환된 페이지 수를 따릅니다. SocQ는 제출된 URL 수를 기준으로 크레딧을 미리 확보해 둘 수 있으며, 작업이 끝나면 실제 result_count로 최종 금액을 정산하고 사용하지 않은 크레딧은 돌려줍니다.

페이지 레코드 이해하기

문서 예시의 행을 일부 줄이면 다음과 같습니다.

{
  "id": "komi:kimkardashian",
  "platform": "link-in-bio",
  "resource": "profile",
  "type": "page",
  "url": "https://kimkardashian.komi.io",
  "service": "komi",
  "username": "kimkardashian",
  "name": "Kim Kardashian",
  "email": null,
  "social_urls": [
    "https://www.instagram.com/kimkardashian/",
    "https://www.tiktok.com/@kimkardashian",
    "https://www.youtube.com/@KUWTK"
  ],
  "links": [
    {
      "title": "Visit SKIMS",
      "url": "https://skims.social/shop-skims",
      "type": "link",
      "thumbnail_url": "https://komi-production-assets.s3-accelerate.amazonaws.com/photos/x_LQCBYzoWiel0-yrAnrF.jpg"
    }
  ],
  "links_count": 21
}

가장 많이 쓰게 될 필드는 다음과 같습니다.

  • id: linktree:miguelangeles처럼 서비스와 페이지 이름을 합친 값입니다. 안정적인 키로 사용하세요.
  • service와 username: 페이지를 호스팅하는 서비스와 그 서비스에서의 페이지 이름.
  • name, text, avatar_url, is_verified: 표시 이름, 소개글, 프로필 사진, 그리고 페이지에 서비스의 인증 배지가 있는지 여부.
  • email: 페이지에 기재된 연락처 이메일(있는 경우).
  • social_urls: 페이지의 아이콘에 연결된 소셜 프로필과 웹사이트.
  • links: 표시되는 순서대로 나열한 모든 링크. title, url, type(link, spotify_album처럼 서비스가 보고하는 값), thumbnail_url이 포함됩니다.
  • links_count: 페이지에 있는 링크 수.

전체 스키마는 Link in Bio 문서에 있습니다.

대량 목록을 배치로 처리하기

긴 목록은 50개씩 나누고 그룹마다 작업을 하나씩 제출하세요. 최소한의 Python 예시는 다음과 같습니다.

import os, time, requests

API = "https://api.socq.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SOCQ_API_KEY']}"}

def read_pages(urls):
    task = requests.post(f"{API}/link-in-bio/profile",
                         json={"urls": urls}, headers=HEADERS).json()
    task_id = task["data"]["task_id"]
    while True:
        time.sleep(3)
        data = requests.get(f"{API}/tasks/{task_id}",
                            params={"limit": 50}, headers=HEADERS).json()["data"]
        if data["status"] in ("succeeded", "failed"):
            return data

for i in range(0, len(all_urls), 50):
    result = read_pages(all_urls[i:i + 50])

프로덕션에서 사용하기 전에 HTTP 상태 확인, 횟수를 제한한 재시도, 커서 페이지네이션을 추가하고, 각 task_id를 입력 배치와 함께 저장하세요.

언제 사용하나요?

아웃리치 연락처 데이터. 크리에이터가 페이지에 연락처 이메일을 기재해 두었다면 email에 담깁니다. 비어 있다면 크리에이터의 메인 프로필에 Influencer Email Finder API를 실행하세요. 이 API는 링크 인 바이오 페이지, 연결된 웹사이트, 다른 계정까지 확인합니다.

크리에이터 계정 매핑. social_urls에는 크리에이터가 직접 정리한 프로필 목록이 담깁니다. 신뢰도 점수가 필요하면 Social Media Profile Finder와 함께 사용하세요. 두 API 모두 Creator API 가이드에서 다룹니다.

스폰서 및 제휴 리서치. links를 보면 크리에이터가 지금 홍보하는 쇼핑몰, 할인 코드, 브랜드 파트너, 콘텐츠를 알 수 있습니다. 시간에 따라 추적하고 collected_at 기준으로 스냅샷을 비교하세요.

카탈로그 데이터 보강. links_count, is_verified, 링크의 type 값을 활용하면 페이지를 하나하나 열어 보지 않고도 크리에이터 데이터베이스에 태그를 달고 필터링할 수 있습니다.

자주 묻는 질문(FAQ)

링크 인 바이오 API란 무엇인가요?

크리에이터가 소셜 프로필 소개에 넣어 두는 랜딩 페이지인 링크 인 바이오 페이지를 읽어 구조화된 데이터로 반환하는 API입니다. SocQ의 Link in Bio API는 Linktree, Komi, lnk.bio, Link.me를 지원합니다.

한 요청에 여러 서비스를 섞어 보낼 수 있나요?

네. Linktree, Komi, lnk.bio, Link.me URL을 같은 urls 배열에 요청당 최대 50개까지 넣을 수 있습니다.

페이지가 삭제된 경우에는 어떻게 되나요?

더 이상 존재하지 않는 페이지는 건너뛰며 과금되지 않습니다. 작업은 제출한 페이지를 하나도 읽을 수 없을 때만 실패 처리되고 환불됩니다.

모든 페이지에 이메일이 포함되나요?

아니요. email은 크리에이터가 페이지에 이메일을 기재한 경우에만 채워지며, 그렇지 않으면 null입니다.

페이지 1,000개를 읽는 데 비용이 얼마나 드나요?

찾은 페이지당 0.5 크레딧이므로 페이지 1,000개는 500 크레딧, 즉 $2.50이며, URL 50개짜리 요청 20회로 제출하면 됩니다.

LINK IN BIO API

공개 Link in Bio URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

Link in Bio API 살펴보기