# agproxy /x402/fetch — Residential Proxy Fetch

> agproxy /x402/fetch — Residential Proxy Fetch is a paid API for AI agents from agproxy.shveik.dev, paid per call via x402, $0.0156/call, status unknown (last checked 2026-10-14).

Fetches a single URL through a residential IP and returns the raw HTTP response (status, headers, body) as JSON, billed per megabyte in USDC.

## Facts

- Endpoint: POST https://agproxy.shveik.dev/x402/fetch?utm_source=zero.xyz
- Price: $0.0156/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agproxy-x402-fetch-residential-proxy-fetch-b163bfb7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kjLUSUuPhH-9ZtCq27TM1

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 agproxy-x402-fetch-residential-proxy-fetch-b163bfb7 -d '<json body>'
```

Example prompt: Use a residential proxy to GET https://www.example.com/products from a US IP address, give me the full response body and status code, and cap it at 5 MB.

## When to prefer this

Choose this endpoint when you need a single URL fetched through a residential IP to avoid datacenter IP blocks, need geo-specific content from a target country, or need the raw HTTP response (status, headers, body) without JavaScript rendering. Prefer this over headless browser APIs when JS execution is not required, as it is faster and cheaper. Prefer this over traditional proxy setups when you need a pay-per-use model in stablecoins with no subscription.

## Known failure modes

- URL unreachable or DNS failure — endpoint may return an error status but no charge is incurred
- Response exceeds max_mb cap — body is truncated and truncated flag is set to true
- Invalid country code (not 2-letter ISO) — request rejected with validation error
- Method not in GET/HEAD/POST enum — request rejected
- URL length exceeds 2000 characters — request rejected
- Payment failure or insufficient USDC balance — 402 response, request not executed
- Request timeout on the remote server — error response returned, not billed

## How this service works

Fetch one URL from a residential IP and get the raw response as JSON: status, final URL, headers and body (text or base64), up to 10 MB. GET, HEAD or POST, your own headers, an optional country. No JavaScript rendering. You pay for the megabytes delivered; a fetch that fails is not charged. Pay per call in stablecoins.

## Output

A JSON object containing: HTTP status code, final URL after redirects, response headers as key-value pairs, response body as text or base64-encoded binary, total bytes received, wire bytes, elapsed time in milliseconds, the country the request was routed through, and a truncated flag if the response was cut at the size limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2000
  },
  "body": {
   "type": "string",
   "maxLength": 1048576
  },
  "max_mb": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1
  },
  "method": {
   "enum": [
    "GET",
    "HEAD",
    "POST"
   ],
   "type": "string"
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$"
  },
  "headers": {
   "type": "object",
   "additionalProperties": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "body": "<!doctyp…",
  "bytes": 577,
  "status": 200,
  "country": null,
  "headers": {},
  "final_url": "https://…",
  "truncated": false,
  "elapsed_ms": 2309,
  "wire_bytes": 8685
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agproxy-x402-fetch-residential-proxy-fetch-b163bfb7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agproxy.shveik.dev](https://www.zero.xyz/host/agproxy.shveik.dev/llms.txt)