크리에이터의 프로필 소개에 있는 링크는 보통 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 살펴보기