# GeekVault Redirect Trace

> GeekVault Redirect Trace is a paid API for AI agents from api.geekvault.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Traces the full chain of HTTP redirects for a given URL, returning each hop's URL and status code plus the final destination URL.

## Facts

- Endpoint: GET https://api.geekvault.dev/net-tools/v1/redirect-trace?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geekvault-redirect-trace-bd009a14
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NffXprI2rFXjsGtSVDV6R

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 geekvault-redirect-trace-bd009a14
```

Example prompt: Can you trace all the redirects for this URL and tell me where it ultimately ends up: https://bit.ly/3xAbCdE?

## When to prefer this

Choose this endpoint when you need to programmatically inspect the full redirect chain of any URL without setting up your own HTTP client, especially useful for security audits, SEO analysis, or verifying affiliate/marketing links. It requires no authentication or subscription — just a USDC micropayment per call, making it ideal for low-volume or one-off agent tasks.

## Known failure modes

- Invalid or malformed URL input returns an error
- URL is unreachable or times out — may return partial hop list or error
- Redirect loop detected — chain may be truncated to prevent infinite following
- Non-redirecting URLs return a single hop with the original URL and its status code

## How this service works

Network, docs, image, web, and dev utility tools paid per call via x402. No signup, no API keys, no subscriptions — just USDC on Base.

## Output

Returns a JSON object with a 'hops' array listing each redirect step (URL and HTTP status code) in order, and a 'final_url' string with the ultimate destination after all redirects are resolved.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "hops",
  "final_url"
 ],
 "properties": {
  "hops": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "url",
     "status"
    ],
    "properties": {
     "url": {
      "type": "string"
     },
     "status": {
      "type": "integer",
      "format": "int32",
      "minimum": 0
     }
    }
   }
  },
  "final_url": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/geekvault-redirect-trace-bd009a14/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.geekvault.dev](https://www.zero.xyz/host/api.geekvault.dev/llms.txt)
