POST AI agent ready /v1/short-url/create

URL 短縮 API - クリックトラッキングを使用して短いリンクを作成する

URL を送信すると、自動生成またはカスタムのスラッグを含む短縮リンクが受信されます。短いリンクは 302 経由でリダイレクトされ、クリック数を追跡します。カスタムスラッグは、文字、数字、ハイフン、アンダースコアをサポートしています。スラッグがすでに取得されている場合、API はエラーを返すため、別のスラッグで再試行できます。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

マーケティングキャンペーン用の追跡可能な短いリンクを生成する

キャンペーンごとにカスタムスラッグの短縮リンクを作成します (例: /launch-2026)。統計エンドポイントを使用して、外部分析ツールを使用せずにクリックを追跡し、エンゲージメントを測定します。

SaaS 製品にリンク短縮機能を組み込む

ユーザーがアプリ内からブランドの短いリンクを作成できるようにします。 API はスラッグ生成、衝突検出、リダイレクト追跡を処理するため、そのインフラストラクチャを構築する必要はありません。

Frequently asked questions

短いリンクには有効期限がありますか?

API を通じて作成された短いリンクには有効期限が組み込まれていません。これらは、手動で削除されるか、基礎となるストレージがクリアされるまで、ストレージ内に残ります。

私のカスタムスラッグがすでに取られている場合はどうなりますか?

API は SLUG_TAKEN エラーを返します。別のスラッグで再試行するか、custom_slug フィールドを省略して自動生成された 6 文字のスラッグを取得できます。

カスタムスラッグではどのような文字が使用できますか?

文字 (A ～ Z、a ～ z)、数字 (0 ～ 9)、ハイフン (-)、およびアンダースコア (_)。他の文字を使用すると、INVALID_SLUG エラーが発生します。

クリック数は自動的に追跡されますか?

はい。誰かが短縮 URL にアクセスするたびに、クリックカウンタが増加します。 /v1/short-url/stats エンドポイントを使用して、現在のカウントを取得します。

短縮 URL はどのようなタイプのリダイレクトを使用しますか?

短縮 URL は 302 (一時) リダイレクトを返します。これは、検索エンジンがリンクエクイティをターゲット URL に転送しないことを意味し、必要に応じて後で宛先を変更できることを意味します。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.