{"uid":"cap_kjLUSUuPhH-9ZtCq27TM1","slug":"agproxy-x402-fetch-residential-proxy-fetch-b163bfb7","name":"agproxy /x402/fetch — Residential Proxy Fetch","description":"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.","url":"https://agproxy.shveik.dev/x402/fetch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}}},"responseSchema":{"type":"json","example":{"body":"<!doctyp…","bytes":577,"status":200,"country":null,"headers":{},"final_url":"https://…","truncated":false,"elapsed_ms":2309,"wire_bytes":8685}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0156","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.0156/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0156","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0156","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qv8iH4d40v86qvyQxoqa8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0156","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single URL through a residential IP and returns the raw HTTP response (status, headers, body) as JSON, billed per megabyte in USDC.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Geo-restricted price check","prompt":"Fetch https://shop.someretailer.com/pricing from a German residential IP so I can see what prices German users are shown — GET request, up to 3 MB please."},{"title":"Anti-bot scraping bypass","prompt":"Pull the HTML from https://listings.propertysite.com/search?city=austin through a residential US IP — I keep getting blocked from my server. GET it and return the full body, up to 5 MB."},{"title":"Redirect chain investigation","prompt":"Send a GET request to https://short.ly/abc123 through a residential proxy and tell me the final URL it lands on, the status code, and all response headers."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T12:38:08.146Z","isFirstParty":false,"canonicalSlug":"agproxy-x402-fetch-residential-proxy-fetch-b163bfb7"}