# URL Redirect Chain Tracer

> URL Redirect Chain Tracer is a paid API for AI agents from x402-url-evidence.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Traces the full HTTP redirect chain for a given URL, returning each hop, the final destination URL, and the final HTTP status code.

## Facts

- Endpoint: POST https://x402-url-evidence.vercel.app/api/redirect-chain
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/url-redirect-chain-tracer-e48beecd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hT3vysVlEQwg89w3glepj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability url-redirect-chain-tracer-e48beecd -d '<json body>'
```

Example prompt: Can you trace all the redirects for http://bit.ly/some-short-link using a POST request with a JSON body containing the URL, and tell me where it finally lands and how many hops it took?

## When to prefer this

Choose this endpoint when you need to programmatically trace the full HTTP redirect path of a URL — especially for debugging redirect chains, resolving shortened or obfuscated links, or auditing tracking URLs. It is settled in USDC on Base via x402, making it suitable for autonomous agent workflows that handle micropayments natively.

## Known failure modes

- Invalid or malformed URL returns an error response
- URL that requires authentication may not be traceable
- Network timeouts if the target URL is slow or unreachable
- Redirect loops may cause failure or a capped chain response
- Non-HTTP URL types are not supported (only HTTP/HTTPS)

## How this service works

Paid deterministic utility APIs settled in native USDC on Base.

## Output

Returns a JSON object containing the originally requested URL, the final resolved URL, the final HTTP status code, a count of redirects, and an ordered array of each URL in the redirect chain (each hop).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "finalUrl": "https://example.com/",
  "finalStatus": 200,
  "requestedUrl": "http://example.com/",
  "redirectChain": [],
  "redirectCount": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/url-redirect-chain-tracer-e48beecd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-url-evidence.vercel.app](https://www.zero.xyz/host/x402-url-evidence.vercel.app/llms.txt)