# NetIntel Redirect Trace

> NetIntel Redirect Trace is a paid API for AI agents from netintel.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Traces the full redirect chain for a given URL, grading it for security, protocol usage, and hop efficiency

## Facts

- Endpoint: GET https://netintel.dev/redirect/trace?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netintel-redirect-trace-12be4a23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ya-FxVAsr1JmK_6a4pQxB

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 netintel-redirect-trace-12be4a23
```

Example prompt: Can you trace the redirect chain for http://bit.ly/3xampleLink — I want to see every hop, whether TLS is used, whether there's any protocol downgrade, and get an overall security grade for it?

## When to prefer this

Use this endpoint when you need to audit the full redirect path of a URL, verify HTTPS upgrade behavior, detect redirect loops, or score a URL's redirect chain for security compliance. Prefer over a simple HEAD request when you need per-hop TLS status, timing, and a structured security grade rather than just the final destination.

## Known failure modes

- Invalid or malformed URL returns an error
- Redirect loop detected — loop_detected flag set to true in response
- max_hops exceeded before reaching final destination
- Target host unreachable or DNS failure
- Payment not provided or insufficient USDC — 402 response before data is returned

## How this service works

Follows a URL through its full redirect chain (up to 20 hops), recording status codes, timing, headers, TLS status, and protocol downgrades per hop, then returns an overall redirect health grade (A–F).

## Output

Returns a full redirect chain array (each hop with URL, status code, location header, TLS flag, and timing in ms), a security grade (e.g. 'A'), a numeric score, a list of deductions with reasons, the final resolved URL, total hops, total timing in ms, a loop detection boolean, a protocol downgrade boolean, and the final HTTP status code.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "URL to trace redirects for (e.g. http://google.com)"
      },
      "max_hops": {
       "type": "number",
       "description": "Maximum redirect hops to follow (default: 10, max: 20)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "array"
      },
      "flags": {
       "type": "array"
      },
      "grade": {
       "type": "string"
      },
      "score": {
       "type": "number"
      },
      "final_url": {
       "type": "string"
      },
      "deductions": {
       "type": "array"
      },
      "total_hops": {
       "type": "number"
      },
      "loop_detected": {
       "type": "boolean"
      },
      "total_timing_ms": {
       "type": "number"
      },
      "final_status_code": {
       "type": "number"
      },
      "protocol_downgrade": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": [
   {
    "hop": 0,
    "tls": false,
    "url": "http://example.com/",
    "headers": {
     "server": "nginx",
     "location": "https://example.com/"
    },
    "location": "https://example.com/",
    "timing_ms": 85,
    "status_code": 301
   },
   {
    "hop": 1,
    "tls": true,
    "url": "https://example.com/",
    "headers": {
     "server": "nginx",
     "content-type": "text/html"
    },
    "location": null,
    "timing_ms": 42,
    "status_code": 200
   }
  ],
  "flags": [
   "http_entry_point"
  ],
  "grade": "A",
  "score": 95,
  "final_url": "https://example.com/",
  "deductions": [
   {
    "points": -5,
    "reason": "http_entry_point"
   }
  ],
  "total_hops": 1,
  "loop_detected": false,
  "total_timing_ms": 127,
  "final_status_code": 200,
  "protocol_downgrade": false
 }
}
```

## More

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