POST AI agent ready /v1/redirect/trace

Redirect Trace API – Verfolgen Sie HTTP-Redirect-Ketten mit Timing

Sendet eine HEAD-Anfrage an eine URL und folgt jedem Weiterleitungs-Hop, bis das endgültige Ziel oder das maximale Hop-Limit erreicht ist. Gibt die ursprüngliche URL, die endgültige URL, die Gesamtzahl der Weiterleitungen, die Gesamtzeit und ein Array von Hops mit URL, Statuscode, Latenz, Server-Header, Standort-Header und Inhaltstyp zurück.

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-Redirect-Audit

Crawlen Sie die URLs Ihrer Website über diesen Endpunkt, um Weiterleitungsketten mit mehr als einem Hop zu finden. Google empfiehlt direkte Weiterleitungen; 301-Ketten verwässern die Link-Equity und verlangsamen die Seitenindizierung.

Debuggen des URL-Shorteners

Fügen Sie eine verkürzte URL ein und sehen Sie sich jeden Hop in der Kette an. Identifizieren Sie, um welchen Weiterleitungsdienst es sich handelt, ob er 301-Weiterleitungen (permanent) oder 302-Weiterleitungen (temporär) verwendet und wo das endgültige Ziel landet.

Analyse der Marketing-Link-Kette

Verfolgen Sie Kampagnen-URLs über UTM-Wrapper, Affiliate-Tracker und CDN-Weiterleitungen. Messen Sie die Latenz, die jeder Hop hinzufügt, und identifizieren Sie Möglichkeiten zur Verkürzung der Kette.

Frequently asked questions

Wie vielen Weiterleitungen folgt es?

Der Endpunkt folgt bis zu 10 Redirect-Hops. Wenn die Kette 10 Hops überschreitet, stoppt sie und gibt die bisher gesammelten Hops zurück, wobei ein Flag anzeigt, dass die Kette abgeschnitten wurde.

Folgt es JavaScript-Weiterleitungen?

Nein. Der Endpunkt folgt Weiterleitungen auf HTTP-Ebene (301, 302, 303, 307, 308). JavaScript-basierte Weiterleitungen (window.location) oder Meta-Refresh-Tags werden nicht erkannt.

Was ist der Unterschied zwischen diesem und /v1/link/expand?

Der Endpunkt /v1/link/expand gibt nur die endgültige Ziel-URL zurück. Dieser Endpunkt gibt die vollständige Kette mit jedem Zwischenhop, Statuscodes, Timing und Server-Headern zurück.

Werden GET- oder HEAD-Anfragen gesendet?

Es sendet HEAD-Anfragen, um die Bandbreite zu minimieren und das Auslösen von Nebenwirkungen auf dem Zielserver zu vermeiden. Der letzte Hop verwendet ebenfalls eine HEAD-Anfrage, sodass content_type verfügbar ist, der Antworttext jedoch nicht abgerufen wird.

Kann ich Weiterleitungen für POST-Endpunkte verfolgen?

Nein. Dieser Endpunkt verfolgt nur GET/HEAD-Umleitungsketten. POST-Weiterleitungen folgen einer anderen HTTP-Semantik (303 vs. 307) und werden nicht unterstützt.

Get your API key

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