API 사용법

프로그램이 링크를 줄이려면 키가 필요합니다. 이 사이트에서 키를 만들고, 복사해서, 프로그램에 붙입니다. 무료 n8n·GitHub 템플릿도 있습니다. UTM·QR·MCP·n8n은 모든 플랜, Slack·GitHub 직장용 레시피는 Business. 이 페이지는 키를 보관하지 않습니다.

사용법

1. 키 만들기

키는 프로그램용 비밀번호입니다. 이 웹사이트에서 만듭니다. 채팅은 키를 만들지 못합니다.

가입하거나 로그인합니다.
API 키를 엽니다. 로그인을 요구하면, 로그인한 뒤 다시 엽니다.
Create New Key를 클릭합니다.
키를 복사합니다. slk_로 시작합니다. 키 전체는 한 번만 보입니다. 잃어버리면 새 키를 만듭니다.

API 키 열기

2. 모든 요청에 키를 넣기

모든 요청에 자신의 키가 필요합니다. 헤더 x-api-key에 넣거나, Authorization: Bearer 뒤에 키를 씁니다.

예시의 YOUR_API_KEY는 빈칸입니다. 자신의 명령에서는 그 글자를 복사한 slk_ 키로 바꿉니다. YOUR_API_KEY라는 글자를 그대로 보내지 마세요.

x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY

예시

▸링크 하나 줄이기

짧은 링크를 하나 만듭니다. slug는 선택입니다. 짧은 이름이며, 글자, 숫자, 하이픈을 씁니다.

curl -X POST https://linkbit.live/api/v1/links \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"destination": "https://example.com/long-url", "slug": "my-link", "utm_source": "newsletter"}'

▸링크 여러 개 줄이기 (요금제에서 최대 100개)

한 요청으로 여러 링크를 만듭니다. 잘못된 줄은 errors로 돌아옵니다. 올바른 줄은 그대로 만들어집니다.

curl -X POST https://linkbit.live/api/v1/links/bulk \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"urls": [
    {"destination": "https://example.com/page1"},
    {"destination": "https://example.com/page2", "slug": "my-custom-slug"}
  ]}'

▸내 링크 목록

이 키의 짧은 링크를 최신순으로 보여 줍니다. 짧은 주소와 클릭 수가 있습니다.

curl https://linkbit.live/api/v1/links \
  -H "x-api-key: YOUR_API_KEY"

▸링크 하나의 클릭

만들기나 목록에서 받은 id를 씁니다. 클릭, 방문자, 국가, 기기, 유입 경로, 하루 합계가 나옵니다.

curl "https://linkbit.live/api/v1/links/LINK_ID/stats?from=2026-01-01&to=2026-01-31" \
  -H "x-api-key: YOUR_API_KEY"

▸계정 전체의 클릭

상위 링크, 하루 숫자, 국가, 기기, 유입 경로입니다.

curl https://linkbit.live/api/v1/analytics \
  -H "x-api-key: YOUR_API_KEY"

n8n, Slack, GitHub

템플릿을 내려받아 x-api-key에 slk_ 키를 넣고 실행하세요. 위 예시와 같은 REST API입니다. UTM·QR·MCP·n8n은 모든 플랜. Slack·GitHub 직장용 레시피는 Pricing의 Business에 있습니다.

n8n — URL 하나 단축 — n8n에 가져온 뒤 slk_YOUR_API_KEY를 바꾸고 Test workflow
n8n — Slack / webhook 단축 — Webhook이 destination JSON을 받아 shortUrl을 반환
GitHub Action — 릴리스 URL 단축 — .github/workflows에 복사하고 시크릿 LINKBIT_API_KEY 설정

UTM·QR·MCP·n8n·Slack이 어떤 플랜에 있는지 보기

각 칸의 뜻

칸	위치	설명
destination	create / bulk	필수입니다. http:// 또는 https://로 시작하는 공개 주소입니다. localhost와 사설 주소는 거절됩니다. 이 칸 이름은 url이어도 됩니다.
slug	create / bulk	선택입니다. 도메인 뒤의 짧은 이름입니다. 글자, 숫자, 하이픈을 씁니다. 공백은 하이픈이 됩니다.
utm_source … utm_content	create / bulk / CSV	선택입니다. 긴 주소에 붙는 캠페인 표입니다. 그 주소에 이미 있는 표는 그대로 둡니다. 끝의 #부분도 남습니다.
urls	bulk body	링크 목록입니다. 이 칸 이름은 links여도 됩니다.
created / errors	bulk response	된 링크와, 실패한 각 링크에 대한 메모입니다.

401은 키가 없거나 틀렸다는 뜻입니다. 400은 주소가 나쁘거나, 오늘 링크를 너무 많이 만들었다는 뜻입니다. 404는 그 링크 id가 없다는 뜻입니다.