sociallinks.dev

API

API 키 받기
요금API일괄로그인API 키 받기

홈 / API 문서

V1
API 키

API 레퍼런스

Social links API

크리에이터 프로필 하나로 모든 계정을 찾습니다. Instagram, TikTok, YouTube, X 프로필 링크를 보내면 다른 플랫폼에 있는 크리에이터의 계정을 각각의 판정, 신뢰도 점수, 근거와 함께 받을 수 있습니다.

기본 URLhttps://sociallinks.dev/v1

할 수 있는 일

크리에이터 조회프로필 링크 하나로 크리에이터의 다른 계정을 찾습니다.POST /resolve여러 크리에이터 조회최대 500개의 프로필을 대기열에 넣으면 백그라운드에서 처리됩니다.POST /batches일괄 작업을 CSV로 내려받기보낸 프로필마다 한 행, 플랫폼마다 한 열이며 상태와 청구된 크레딧도 포함됩니다.GET /batches/{id}/export잔액 확인키에 연결된 계정의 남은 크레딧입니다.GET /balance
OpenAPI 명세코드 생성기와 AI 에이전트를 위한 전체 명세입니다.
보기

인증

대시보드 → API에서 키를 만들고 모든 요청에 Authorization: Bearer sl_…(또는 x-api-key: sl_…)로 보내세요. 키는 계정의 크레딧을 사용합니다. 키는 만들 때 한 번만 표시되며, 폐기하면 즉시 작동을 멈춥니다.

MCP 서버

Claude Code, Cursor, VS Code, Windsurf, Gemini CLI 등 MCP 클라이언트에서 조회하세요. https://sociallinks.dev/mcp을 원격(Streamable HTTP) 서버로 추가하고 API 키를 Authorization 헤더로 보내면 됩니다. 도구 요금은 REST 엔드포인트와 똑같습니다.

claude mcp add --transport http sociallinks https://sociallinks.dev/mcp --header "Authorization: Bearer sl_your_key"

설정 위치: Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

도구

  • lookup_creator

    프로필 URL로 크리에이터 한 명을 조회합니다. 계정을 찾았을 때만 차감됩니다.

  • check_balance

    키에 연결된 계정의 남은 크레딧. 무료.

  • start_batch

    많은 프로필 URL을 대기열에 넣어 백그라운드에서 조회합니다.

  • get_batch

    배치의 진행 상황과 결과 행.

결제

보낸 계정 외에 계정을 하나 이상 찾으면 크리에이터당 1 크레딧입니다. 아무것도 찾지 못한 조회와 실패한 조회는 무료입니다. 최근 30일 안에 내 계정으로 결제한 크리에이터를 다시 조회하는 것도 무료입니다. 크레딧은 웹사이트와 공유됩니다. 요금을 참고하세요.

크리에이터 조회

POST/resolve

Instagram, TikTok, YouTube, X 프로필 URL을 하나 보내세요. 다른 플랫폼에 있는 크리에이터의 계정을 각각의 판정, 종합 신뢰도 점수, 근거와 함께 받습니다. 새 조회는 10~40초가 걸리고, 이미 가지고 있는 크리에이터는 즉시 돌아옵니다. 계정을 하나 이상 찾으면 1 크레딧이며, 아무것도 찾지 못하면 무료입니다. X-Credits-Remaining 헤더에 잔액이 들어 있습니다.

매개변수

  • urlbody · string필수

    크리에이터의 프로필 페이지입니다. 게시물, 릴스, 동영상, @핸들만 있는 경우는 400으로 거부됩니다.

요청

curl -X POST "https://sociallinks.dev/v1/resolve" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/mkbhd"}'

응답(200)

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

크리에이터 조회(GET)

GET/resolve

POST /resolve와 같으며, GET 요청만 보낼 수 있는 도구를 위한 것입니다.

매개변수

  • urlquery · string필수

    URL 인코딩된 크리에이터 프로필 페이지입니다.

요청

curl "https://sociallinks.dev/v1/resolve?url=https%3A%2F%2Fwww.instagram.com%2Fmkbhd" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

응답(200)

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

여러 크리에이터 조회

POST/batches

각 행은 계정을 찾았을 때만 청구되며, 최근 30일 안에 내 계정으로 결제한 행은 무료입니다. 프로필 링크가 아닌 행은 건너뛰고 청구하지 않습니다. 일괄 작업 상태를 확인한 뒤 CSV를 내려받으세요.

매개변수

  • urlsbody · string[] | string필수

    최대 500개의 프로필 URL. 배열로 보내거나 한 줄에 하나씩 보내세요.

  • namebody · string

    일괄 작업의 이름입니다.

요청

curl -X POST "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Q4 shortlist","urls":["https://www.tiktok.com/@zachking","https://www.youtube.com/@mkbhd"]}'

응답(201)

{
  "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
  "rows": 2,
  "invalid": 0,
  "duplicates": 0
}

일괄 작업 확인

GET/batches/{id}

status가 "completed", "partial", "failed" 중 하나가 될 때까지 몇 초마다 확인하세요. 각 항목에는 자체 상태와 찾은 계정이 들어 있습니다.

매개변수

  • idpath · uuid필수

    POST /batches가 반환한 id입니다.

요청

curl "https://sociallinks.dev/v1/batches/$BATCH_ID" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

응답(200)

{
  "batch": {
    "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
    "name": "Q4 shortlist",
    "status": "completed",
    "total": 2,
    "succeeded": 2,
    "empty": 0,
    "failed": 0,
    "skipped": 0,
    "charged": 2,
    "created_at": "2026-10-19T09:30:00Z"
  },
  "items": [
    {
      "position": 0,
      "input": { "url": "https://www.tiktok.com/@zachking" },
      "status": "succeeded",
      "charged": 1,
      "result": {
        "name": "Zach King",
        "profiles": [{ "platform": "youtube", "handle": "ZachKing", "url": "https://www.youtube.com/@ZachKing", "verdict": "confirmed" }],
        "notFound": ["linkedin"]
      }
    }
  ]
}

일괄 작업을 CSV로 내려받기

GET/batches/{id}/export

스프레드시트나 CRM 가져오기에 바로 쓸 수 있습니다.

매개변수

  • idpath · uuid필수

    일괄 작업 id입니다.

요청

curl "https://sociallinks.dev/v1/batches/$BATCH_ID/export" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" -o results.csv

응답(200)

row,input,status,credits,creator,verified_creator,instagram,youtube,tiktok,x,twitch,facebook,linkedin,nothing_found_on,error
1,https://www.tiktok.com/@zachking,succeeded,1,Zach King,no,https://www.instagram.com/zachking,https://www.youtube.com/@ZachKing,https://www.tiktok.com/@zachking,https://x.com/zachking,,https://www.facebook.com/zachking,,linkedin,

일괄 작업 목록

GET/batches

중단한 곳에서 이어갈 때 편리합니다.

매개변수

없음.

요청

curl "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

응답(200)

{
  "batches": [
    {
      "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
      "name": "Q4 shortlist",
      "status": "completed",
      "total": 2,
      "succeeded": 2,
      "empty": 0,
      "failed": 0,
      "skipped": 0,
      "charged": 2,
      "created_at": "2026-10-19T09:30:00Z"
    }
  ]
}

일괄 작업 중지

POST/batches/{id}/cancel

이미 실행 중인 행은 끝까지 처리됩니다. 일괄 작업이 이미 끝났다면 409를 반환합니다.

매개변수

  • idpath · uuid필수

    일괄 작업 id입니다.

요청

curl -X POST "https://sociallinks.dev/v1/batches/$BATCH_ID/cancel" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

응답(200)

{ "ok": true }

잔액 확인

GET/balance

웹사이트와 같은 크레딧입니다. 팩은 https://sociallinks.dev/pricing에서 구매하세요.

매개변수

없음.

요청

curl "https://sociallinks.dev/v1/balance" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

응답(200)

{ "credits": 742 }

오류

모든 오류는 { "error": { "message", "code" } } 형식입니다. message는 읽기 쉬운 문장이고, 분기 처리가 필요할 때는 code를 사용하세요.

상태코드의미
400—프로필 URL이 아니거나(게시물, 릴스, 동영상, @핸들만 있는 경우는 거부됩니다) 본문이 없습니다.
401invalid_api_key알 수 없거나 폐기된 키입니다.
401login_required키를 보내지 않았습니다.
402out_of_credits크레딧이 없습니다. 아무것도 청구되지 않았습니다. 팩을 구매한 뒤 다시 시도하세요.
404—이 계정에 해당 일괄 작업이 없습니다.
409—일괄 작업이 이미 끝났습니다.
429—새 조회가 너무 많습니다. Retry-After에 표시된 초만큼 기다리거나 목록을 /batches로 보내세요.
502—저희 쪽에서 조회에 실패했습니다. 청구되지 않았으니 다시 시도하세요.

요청 한도

키당 새 조회분당 5회
이미 조회한 크리에이터제한 없음, 즉시 응답
일괄 작업당 프로필 수500
계정당 활성 API 키10

지원

질문이나 버그가 있나요? support@youtubetranscript.dev로 메일을 보내주세요.