LinkBit

APIの使い方

プログラムがリンクを短くするには、キーが必要です。このサイトでキーを作り、コピーして、プログラムに貼ります。無料のn8n・GitHubテンプレートもあります。UTM・QR・MCP・n8nは全プラン、Slack・GitHubの職場レシピはBusiness。このページはキーを保存しません。

使い方

1. キーを作る

キーは、プログラム用のパスワードです。このサイトで作ります。チャットはキーを作れません。

  1. 会員登録するか、ログインします。
  2. APIキーを開きます。ログインを求められたら、ログインしてからもう一度開きます。
  3. Create New Key をクリックします。
  4. キーをコピーします。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

例

▸リンクを1つ短くする

短いリンクを1つ作ります。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 件）

1回のリクエストで多くのリンクを作ります。悪い行は 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"
▸1つのリンクのクリック

作成か一覧でもらった id を使います。クリック、訪問者、国、端末、参照元、1日の合計が返ります。

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"
▸アカウント全体のクリック

上位のリンク、1日の数、国、端末、参照元です。

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にあります。

UTM・QR・MCP・n8n・Slackがどのプランに含まれるか見る

各欄の意味

欄場所説明
destinationcreate / bulk必須です。http:// または https:// で始まる普通の公開アドレスです。localhost とプライベートなアドレスは拒否されます。この欄の名前は url でもかまいません。
slugcreate / bulk任意です。ドメインのうしろの短い名前です。英数字とハイフンを使います。空白はハイフンになります。
utm_source … utm_contentcreate / bulk / CSV任意です。長いアドレスに付けるキャンペーンの印です。そのアドレスにすでにある印はそのままです。末尾の # の部分も残ります。
urlsbulk bodyリンクの一覧です。この欄の名前は links でもかまいません。
created / errorsbulk responseできたリンクと、失敗した各リンクのメモです。

401は、キーがないか、キーが違うという意味です。400は、アドレスが悪いか、今日リンクを作りすぎたという意味です。404は、そのリンクの id がないという意味です。

ログインしたあと、リンク一覧を開きます。各リンクからQRコードを出せます。