{"uid":"cap_SyUdT7PrfgsfIZr5F_54o","slug":"readfetch-residential-scrape-41517b9a","name":"ReadFetch Residential Scrape","description":"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.","url":"https://readfetch.com/v1/scrape/residential?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ve0drOhyG6ug7NbJuxpYS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes a URL through a rotating residential IP address to bypass bot-detection systems like DataDome, PerimeterX, and Cloudflare WAF.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Scraping Cloudflare-protected pricing page","prompt":"Can you grab the pricing page at https://competitor.com/pricing? It's behind Cloudflare and keeps blocking normal scrapes — use a residential IP and return it as markdown."},{"title":"Extracting data from DataDome-protected site","prompt":"I need the content from https://retailsite.com/deals today — it uses DataDome and rejects datacenter traffic. Fetch it through a residential address in full render mode and give me the markdown."},{"title":"Accessing PerimeterX-protected product listings","prompt":"Fetch https://brandstore.com/collections/new-arrivals through a residential proxy — the site uses PerimeterX and blocks everything else — render mode, and give me the text output."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:41.570Z","isFirstParty":false,"canonicalSlug":"readfetch-residential-scrape-41517b9a"}