# Apollo Proxy Relay — Residential Proxy Fetch

> Apollo Proxy Relay — Residential Proxy Fetch is a paid API for AI agents from apolloai.team, paid per call via x402, $0.01/call, status down (last checked 2026-09-15).

Fetches a target URL through residential proxy infrastructure (190+ countries, 250KB cap) and returns the response body, status code, and content type.

## Facts

- Endpoint: GET https://apolloai.team/api/proxy/request
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apollo-proxy-relay-residential-proxy-fetch-d5247232
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fqGW5Z6-B7CnbPXSGy1gv

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 apollo-proxy-relay-residential-proxy-fetch-d5247232
```

Example prompt: Can you fetch the content of https://example.com/product-page through a residential proxy in Germany for me?

## When to prefer this

Use this endpoint when you need a single one-off HTTP GET/HEAD/DELETE request proxied through a residential IP, especially when geo-targeting a specific country is needed and the response fits within 250KB. Prefer this over the session proxy endpoint when you don't need IP persistence across multiple requests.

## Known failure modes

- Target URL unreachable or returns non-2xx: response body and status_code reflect the upstream error
- Response exceeds 250KB cap: truncated or rejected response
- Invalid or unsupported country code: may fall back to default exit IP or return an error
- Rate limit exceeded (100/min): request throttled
- Malformed target_url parameter: missing required queryParams

## How this service works

Proxy relay: send a target URL, we fetch through residential proxies (250KB cap, 190+ countries).

## Output

Returns a JSON object with status 'success', the proxied response body (up to 250KB), the HTTP status code of the target URL, and the content type. Also includes rate limit metadata (100 requests/min, 256000 byte max).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "target_url"
     ],
     "properties": {
      "method": {
       "enum": [
        "GET",
        "POST",
        "PUT",
        "DELETE"
       ],
       "type": "string",
       "description": "HTTP method"
      },
      "country": {
       "type": "string",
       "description": "2-letter country code for exit IP (e.g. US, DE, JP)"
      },
      "target_url": {
       "type": "string",
       "description": "URL to fetch through proxy"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "limits": {
   "max_bytes": 256000,
   "rate_limit": "100/min"
  },
  "status": "success",
  "service": "Apollo Proxy Relay",
  "response": {
   "body": "...",
   "status_code": 200,
   "content_type": "text/html"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apollo-proxy-relay-residential-proxy-fetch-d5247232/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apolloai.team](https://www.zero.xyz/host/apolloai.team/llms.txt)
