{"uid":"cap_RARH362ssaYA71o9_xUYf","slug":"agents-zenrows-com-zenrows-fetch-a-page-5726acc5","name":"Zenrows Fetch a Page","description":"Retrieve a URL through Zenrows and return its content. The same operation covers Extract (`extract=auto` or `css_extractor`), format conversion (`response_type`), screenshots and structured output, because they are configurations of one request rather than separate endpoints.","url":"https://agents.zenrows.com/v1/?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","examples":["https://www.scrapingcourse.com/ecommerce/"],"description":"The URL of the page to retrieve."},"mode":{"enum":["auto"],"type":"string","description":"Adaptive Stealth Mode. `auto` starts from the cheapest viable configuration and escalates to JavaScript rendering or premium proxies only when the target requires it. You are billed for the configuration that succeeds."},"wait":{"type":"integer","default":0,"minimum":0,"description":"Milliseconds to wait after load before returning. Requires js_render."},"extract":{"enum":["auto","native","standard"],"type":"string","description":"Return structured JSON extracted from the page with no selectors to write (Extract). Omit it and Extract is off. `auto` and `native` return the website's own field names; `standard` returns a canonical schema shared by every website in a vertical (real estate only for now). Extract works on any prepared domain, with any active API key (prepare a new one with `POST /extract/prepared-domains`), and is currently free on top of the Fetch cost. A domain, or a kind of page on it, that is not prepared yet answers 403 `REQS007`: see `requestExtractDomain`."},"outputs":{"type":"string","description":"Comma-separated data types to pull out of the retrieved HTML (for example `emails,phone_numbers`)."},"wait_for":{"type":"string","description":"CSS selector to wait for before returning. Requires js_render."},"autoparse":{"type":"boolean","default":false,"description":"Deprecated in favour of Extract (`extract=auto`). Returns general-purpose JSON parsed from the page, not tailored to the website."},"js_render":{"type":"boolean","default":false,"description":"Render the page in a headless browser before returning it. Required for content that only exists after JavaScript runs."},"screenshot":{"type":"boolean","default":false,"description":"Return an above-the-fold screenshot of the page. Requires js_render."},"session_id":{"type":"integer","description":"Reuse the same IP across requests for up to 10 minutes. Any integer you choose identifies the session."},"css_extractor":{"type":"string","examples":["{\"title\":\"h1\",\"price\":\".price\"}"],"description":"JSON object mapping output keys to CSS selectors, applied to the retrieved page."},"json_response":{"type":"string","description":"Return a JSON envelope that also carries the network requests (XHR/fetch) the page made."},"premium_proxy":{"type":"boolean","default":false,"description":"Route the request through residential IPs. Required by most protected sites."},"proxy_country":{"type":"string","pattern":"^[a-z]{2}$","examples":["us"],"description":"Two-letter country code for the exit IP. Requires premium_proxy."},"response_type":{"enum":["markdown","plaintext","pdf"],"type":"string","description":"Convert the page before returning it: Markdown, plaintext or PDF."},"custom_headers":{"type":"boolean","default":false,"description":"Forward your own request headers (cookies, referer) to the target."},"extract_fields":{"type":"string","examples":["products.name,products.price"],"description":"Comma-separated list of the fields `extract` should return, dot-notated for fields inside a group (for example `products.name,products.price`). Omit it to receive every field."},"block_resources":{"type":"string","description":"Comma-separated resource types to block (for example `image,media,font`). Blocking is on by default."},"js_instructions":{"type":"string","description":"JSON array of browser instructions (click, fill, scroll, wait) executed on the page before the content is returned. Requires js_render."},"original_status":{"type":"boolean","default":false,"description":"Return the target's own HTTP status code instead of the Zenrows one."},"screenshot_format":{"enum":["png","jpeg"],"type":"string","default":"png","description":"Screenshot image format."},"screenshot_quality":{"type":"integer","maximum":100,"minimum":1,"description":"JPEG quality, 1 to 100. Only with screenshot_format=jpeg."},"screenshot_fullpage":{"type":"boolean","default":false,"description":"Return a full-page screenshot. Requires js_render."},"screenshot_selector":{"type":"string","description":"Screenshot only the element matching this CSS selector. Requires js_render."},"allowed_status_codes":{"type":"string","description":"Comma-separated status codes whose body should be returned instead of raising an error, for example `404,500`."}}},"responseSchema":{"type":"object","description":"Structured output: the extracted fields, the autoparsed record, or the JSON envelope with captured network requests.","additionalProperties":true},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.83","successRate":"1.00","reviews":1,"stars":"4.3","state":"rated"},"availabilityStatus":"healthy","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_OYHByTFAWvXF9juc09Zpk","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.zenrows.com","brandSlug":"agents-zenrows-com-x402","brandBaseUrl":"https://agents.zenrows.com","brandDocsUrl":null,"whatItDoes":"Retrieve the content of any public web page through Zenrows, with optional JavaScript rendering, proxy routing, extraction, screenshots, and structured output.","exampleAgentPrompt":"Fetch the full HTML of https://www.example.com/products using JavaScript rendering and route it through a US residential proxy so we can get past any anti-bot protection.","exampleUseCases":[{"title":"Scrape JavaScript-rendered product page","prompt":"Get the full content of https://www.amazon.com/dp/B0EXAMPLE — it only shows prices after JavaScript runs, so make sure to render it in a headless browser and pull out the structured product data."},{"title":"Extract contact info from business directory","prompt":"Grab the page at https://yellowpages.com/some-listing and pull out all the emails and phone numbers you can find on it."},{"title":"Screenshot competitor landing page","prompt":"Take a screenshot of https://competitor.com and return it to me — I want to see exactly what their homepage looks like above the fold right now."}],"resultDescription":"Returns the page content in the requested format: raw HTML by default, or Markdown, plain text, PDF, or structured JSON depending on response_type and extract settings. If screenshot=true, returns an image of the above-the-fold view. If css_extractor or extract=auto is used, returns a JSON object with the extracted fields. If json_response=true, may include network request logs.","failureModes":["Invalid or unreachable URL returns an error response","Anti-bot protection not bypassed even with premium proxy — page returns incomplete or blocked content","js_render=false on a JavaScript-heavy page returns empty or incomplete HTML","wait_for selector never appears — request times out","Invalid API key returns 401 unauthorized","Insufficient credits returns 402 payment required","Rate limiting on the target site causes failed fetch"],"whenToPreferThis":"Use this endpoint when you need to retrieve content from public web pages, especially those protected by anti-bot systems or requiring JavaScript rendering. It is ideal when you need flexible output formats (HTML, Markdown, JSON, screenshot), structured extraction without writing parsers, or geo-targeted proxy routing. Prefer this over generic HTTP fetch libraries when the target site has bot protection, uses client-side rendering, or when you need to interact with the page before capturing content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-10-15T01:52:32.967Z","lastSuccessfullyRanAt":"2026-10-15T01:52:32.967Z","lastHealthCheckAt":"2026-10-18T21:07:03.016Z","isFirstParty":false,"canonicalSlug":"agents-zenrows-com-zenrows-fetch-a-page-5726acc5"}