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

短縮 URL 統計 API - 無料のクリック分析

短縮 URL のスラッグを送信すると、そのクリック数、元の URL、および作成タイムスタンプを受け取ります。これを使用して、/v1/short-url/create エンドポイント経由で作成されたリンクのエンゲージメントを追跡します。ユーザーが短いリンクをクリックすると、統計がリアルタイムで更新されます。

Endpoint

Code examples

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

When to use this API

管理ダッシュボードでキャンペーンリンクのパフォーマンスを追跡する

各キャンペーンリンクの統計エンドポイントをポーリングし、コンバージョンデータとともにクリック数を表示します。これにより、マーケティングチームはどのチャネルがトラフィックを促進しているかを明確に把握できるようになります。

リンクがクリックしきい値に達したときに自動化をトリガーする

クリック数を定期的に確認します。リンクがしきい値 (1000 クリックなど) を超えると、通知がトリガーされ、リンクがローテーションされるか、リーダーボードが更新されます。

共有リンクのレポートページを作成する

リンク作成者に、短縮 URL がクリックされた回数を表示します。シンプルな分析ビューで、元の URL、作成日、合計クリック数を表示します。

Frequently asked questions

クリック数はリアルタイムで更新されますか?

はい。リダイレクトごとにカウンターが増加します。キー/値ストアの結果整合性により、1 秒未満の遅延が発生する可能性がありますが、実用上は即時です。

クリックカウンターをリセットできますか?

いいえ。クリック数をリセットするエンドポイントはありません。新しいカウンターが必要な場合は、別のスラッグで新しい短いリンクを作成します。

ナメクジが存在しない場合はどうなりますか?

API はコード NOT_FOUND の 404 エラーを返します。スラグのスペルを再確認するか、新しい短いリンクを作成してください。

統計エンドポイントはボットトラフィックを個別にカウントしますか?

いいえ。クリックカウンターは、ボット、クローラー、プレビューフェッチャーを含むすべてのリダイレクトリクエストを追跡します。必要に応じて、ボットトラフィックを側でフィルタリングします。

他のユーザーが作成したリンクの統計を取得できますか?

はい。統計情報は、ナメクジを知っている人なら誰でもアクセスできます。個々の短いリンクには所有権やアクセス制御はありません。

Get your API key

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