POST AI agent ready /v1/redirect/trace

リダイレクトトレース API - タイミングを合わせて HTTP リダイレクトチェーンを追跡する

HEAD リクエストを URL に送信し、最終宛先または最大ホップ制限に達するまで、すべてのリダイレクトホップをたどります。元の URL、最終 URL、合計リダイレクト数、合計時間、および URL、ステータスコード、レイテンシー、サーバーヘッダー、ロケーションヘッダー、およびコンテンツタイプを含むホップの配列を返します。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/redirect/trace \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bit.ly/example"}'

When to use this API

SEOリダイレクト監査

このエンドポイントを通じてサイト URL をクロールして、複数のホップを持つリダイレクトチェーンを見つけます。 Google は直接リダイレクトを推奨しています。 301 が連鎖すると、リンクの価値が低下し、ページのインデックス作成が遅くなります。

URL短縮機能のデバッグ

短縮 URL を貼り付けると、チェーン内のすべてのホップが表示されます。どのリダイレクトサービスが関係しているか、301 (永続) または 302 (一時) リダイレクトのどちらを使用しているか、および最終的な宛先がどこに到達するかを特定します。

マーケティングリンクチェーン分析

UTM ラッパー、アフィリエイトトラッカー、CDN リダイレクトを通じてキャンペーン URL を追跡します。各ホップによって追加されるレイテンシーを測定し、チェーンを短縮する機会を特定します。

Frequently asked questions

リダイレクトは何回続きますか?

エンドポイントは最大 10 個のリダイレクトホップをたどります。チェーンが 10 ホップを超える場合、チェーンは停止し、チェーンが切り詰められたことを示すフラグを付けて、それまでに収集されたホップを返します。

JavaScript リダイレクトに従いますか?

いいえ。エンドポイントは HTTP レベルのリダイレクト (301、302、303、307、308) に従います。 JavaScript ベースのリダイレクト (window.location) またはメタ更新タグは検出されません。

これと /v1/link/expand の違いは何ですか?

/v1/link/expand エンドポイントは、最終的な宛先 URL のみを返します。このエンドポイントは、すべての中間ホップ、ステータスコード、タイミング、サーバーヘッダーを含む完全なチェーンを返します。

GET リクエストまたは HEAD リクエストを送信しますか?

HEAD リクエストを送信して帯域幅を最小限に抑え、ターゲットサーバーでの副作用の発生を回避します。最終ホップでも HEAD リクエストが使用されるため、content_type は利用可能ですが、応答本文はフェッチされません。

POST エンドポイントのリダイレクトをトレースできますか?

いいえ。このエンドポイントは GET/HEAD リダイレクトチェーンのみをトレースします。 POST リダイレクトは、異なる HTTP セマンティクス (303 対 307) に従っており、サポートされていません。

Get your API key

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