GET
$0.01 default
/Description
Trace an HTTP redirect chain to its final destination without downloading page bodies. Returns every hop (URL + status), the final URL, and safety warnings — link-safety grounding for agents before they visit or cite a URL. Clean JSON.
Pricing
$0.01 default
Parameters
{
"properties": {
"url": {
"description": "Absolute URL to trace. Scheme must be http or https; host must be a hostname (not an IP literal), not \"localhost\", and not under a reserved suffix (.local, .internal, .localdomain, .lan, .test); an explicit port must be the scheme default or on the server's allowlist.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}Example response
{
"final_url": "https://example.com/landing",
"hops": [
{
"location": "https://t.co/abcd",
"status_code": 301,
"url": "https://bit.ly/example"
},
{
"location": "https://example.com/landing",
"status_code": 302,
"url": "https://t.co/abcd"
},
{
"status_code": 200,
"url": "https://example.com/landing"
}
],
"queried_at": "2026-07-03T12:00:00Z",
"redirect_count": 2,
"redirected": true,
"status_code": 200,
"url": "https://bit.ly/example",
"warnings": []
}