# ReadFetch Residential Scrape

> ReadFetch Residential Scrape is a paid API for AI agents from readfetch.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Scrapes a URL through a rotating residential IP address to bypass bot-detection systems like DataDome, PerimeterX, and Cloudflare WAF.

## Facts

- Endpoint: POST https://readfetch.com/v1/scrape/residential?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readfetch-residential-scrape-41517b9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SyUdT7PrfgsfIZr5F_54o

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 readfetch-residential-scrape-41517b9a -d '<json body>'
```

Example prompt: Fetch the full page content from https://www.example-shop.com/product/123 using a residential IP — it keeps blocking datacenter requests — and return the result as markdown.

## When to prefer this

Use this endpoint specifically when the standard datacenter-based scrape (/v1/scrape) is being blocked by IP-reputation systems such as DataDome, PerimeterX, Cloudflare Bot Management, or AWS WAF. It is four times the price of the standard scrape, so prefer the cheaper datacenter endpoint first and escalate to this only when bot-detection is confirmed. Choose this over generic residential proxy services when you also need browser rendering, structured output formats (markdown/text/HTML), and a simple single-call API without managing proxy pools yourself.

## Known failure modes

- Target site blocks even residential IPs (returns error or empty content)
- URL is malformed or unreachable (validation error on input)
- Residential node timeout causes request failure (no retry)
- Site requires authentication not provided in the auth field (returns login page or 4xx)
- Page renders but content is behind a CAPTCHA that residential routing alone cannot solve

## How this service works

Identical request and response to /v1/scrape, but the render leaves through a rotating residential address instead of the datacentre. For targets that block by IP reputation (DataDome, PerimeterX, Cloudflare, AWS WAF). One attempt, no retries: residential bandwidth is the cost, and four times the scrape price is what it takes to cover it honestly.

## Output

Returns the scraped page content in the requested format (markdown, text, or HTML) after rendering through a residential IP. The response mirrors the standard /v1/scrape endpoint but routed via rotating residential addresses to evade IP-reputation-based bot defenses. One attempt is made with no automatic retries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "title": "Url",
   "format": "uri",
   "maxLength": 2083,
   "minLength": 1
  },
  "auth": {
   "anyOf": [
    {
     "$ref": "#/$defs/Auth"
    },
    {
     "type": "null"
    }
   ],
   "default": null
  },
  "mode": {
   "enum": [
    "fast",
    "render",
    "full"
   ],
   "type": "string",
   "title": "Mode",
   "default": "render"
  },
  "fresh": {
   "type": "boolean",
   "title": "Fresh",
   "default": false
  },
  "format": {
   "enum": [
    "markdown",
    "text",
    "html"
   ],
   "type": "string",
   "title": "Format",
   "default": "markdown"
  },
  "options": {
   "anyOf": [
    {
     "$ref": "#/$defs/ScrapeOptions"
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "deprecated": true,
   "description": "Deprecated — use `advanced` instead (same ScrapeOptions shape). Scheduled for removal in a future API semver bump."
  },
  "advanced": {
   "anyOf": [
    {
     "$ref": "#/$defs/ScrapeOptions"
    },
    {
     "type": "null"
    }
   ],
   "default": null
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readfetch-residential-scrape-41517b9a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from readfetch.com](https://www.zero.xyz/host/readfetch.com/llms.txt)