---
name: orthogonal-zenrows
description: "Call ZenRows through Orthogonal's pay-per-use Run API: ZenRows web data API: fetch any URL with anti-bot bypass, JavaScript rendering and premium residential proxies, returning HTML, Markdown, plaintext, PDF, screenshots or structured JSON (Extract, CSS selectors), plus Crawl to collect the pages behind a start URL."
---

# ZenRows — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://www.orthogonal.com/llms.txt) · [browse all APIs](https://www.orthogonal.com/catalog)

ZenRows web data API: fetch any URL with anti-bot bypass, JavaScript rendering and premium residential proxies, returning HTML, Markdown, plaintext, PDF, screenshots or structured JSON (Extract, CSS selectors), plus Crawl to collect the pages behind a start URL.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://www.orthogonal.com/account/keys

No account or key yet? Set up Orthogonal first with https://www.orthogonal.com/skill.md: it covers the CLI, the MCP server, the TypeScript SDK and sign-up, including an agent sign-up without a password (https://www.orthogonal.com/agent-signup.md).

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "priceCents": <US cents>, "requestId": "...", "data": { ... } }`.

Quote first, free: the same request with `"dryRun": true` returns the price without calling the API or charging anything. On a retry after a timeout, send the same `Idempotency-Key` header so the call runs and bills once.

## Endpoints

### Page fetch

Fetch a page (ZenRows Fetch, formerly Universal Scraper API): retrieve any URL with anti-bot bypass, optional JavaScript rendering (js_render), premium residential proxies (premium_proxy, proxy_country) or Adaptive Stealth Mode (mode=auto). Returns HTML, or Markdown/plaintext/PDF (response_type), screenshots, CSS-selected or Extract structured JSON.

`GET /`

**Estimated cost:** from $0.00046 per call (required params only), up to $0.0115; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/zenrows/3eed129c-92d3-49ee-8bf1-6211eea81e34

**Docs:** https://docs.zenrows.com/api-reference/fetch/fetch-a-page

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The URL of the page to retrieve. |
| `mode` | string | No | 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. |
| `js_render` | boolean | No | Render the page in a headless browser before returning it. Required for content that only exists after JavaScript runs. |
| `js_instructions` | string | No | JSON array of browser instructions (click, fill, scroll, wait) executed on the page before the content is returned. Requires js_render. |
| `custom_headers` | boolean | No | Forward your own request headers (cookies, referer) to the target. |
| `premium_proxy` | boolean | No | Route the request through residential IPs. Required by most protected sites. |
| `proxy_country` | string | No | Two-letter country code for the exit IP. Requires premium_proxy. |
| `session_id` | integer | No | Reuse the same IP across requests for up to 10 minutes. Any integer you choose identifies the session. |
| `original_status` | boolean | No | Return the target's own HTTP status code instead of the Zenrows one. |
| `allowed_status_codes` | string | No | Comma-separated status codes whose body should be returned instead of raising an error, for example `404,500`. |
| `wait_for` | string | No | CSS selector to wait for before returning. Requires js_render. |
| `wait` | integer | No | Milliseconds to wait after load before returning. Requires js_render. |
| `block_resources` | string | No | Comma-separated resource types to block (for example `image,media,font`). Blocking is on by default. |
| `json_response` | string | No | Return a JSON envelope that also carries the network requests (XHR/fetch) the page made. |
| `css_extractor` | string | No | JSON object mapping output keys to CSS selectors, applied to the retrieved page. |
| `extract` | string | No | 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 |
| `extract_fields` | string | No | 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. |
| `autoparse` | boolean | No | Deprecated in favour of Extract (`extract=auto`). Returns general-purpose JSON parsed from the page, not tailored to the website. |
| `response_type` | string | No | Convert the page before returning it: Markdown, plaintext or PDF. |
| `screenshot` | boolean | No | Return an above-the-fold screenshot of the page. Requires js_render. |
| `screenshot_fullpage` | boolean | No | Return a full-page screenshot. Requires js_render. |
| `screenshot_selector` | string | No | Screenshot only the element matching this CSS selector. Requires js_render. |
| `screenshot_format` | string | No | Screenshot image format. |
| `screenshot_quality` | integer | No | JPEG quality, 1 to 100. Only with screenshot_format=jpeg. |
| `outputs` | string | No | Comma-separated data types to pull out of the retrieved HTML (for example `emails,phone_numbers`). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/","method":"GET","query":{"url":"<string>","mode":"<string>","js_render":"<boolean>","js_instructions":"<string>","custom_headers":"<boolean>","premium_proxy":"<boolean>","proxy_country":"<string>","session_id":"<integer>","original_status":"<boolean>","allowed_status_codes":"<string>","wait_for":"<string>","wait":"<integer>","block_resources":"<string>","json_response":"<string>","css_extractor":"<string>","extract":"<string>","extract_fields":"<string>","autoparse":"<boolean>","response_type":"<string>","screenshot":"<boolean>","screenshot_fullpage":"<boolean>","screenshot_selector":"<string>","screenshot_format":"<string>","screenshot_quality":"<integer>","outputs":"<string>"}}'
```

### Page fetch via POST

Fetch a page with a POST: same as Page fetch, but sends a POST to the target URL and forwards the request body to it as is. All ZenRows options go in the query string.

`POST /`

**Estimated cost:** from $0.00046 per call (required params only), up to $0.0115; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/zenrows/7a9e7d9b-9060-4c8d-a3b6-663f7b8ba61b

**Docs:** https://docs.zenrows.com/api-reference/fetch/fetch-a-page

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The URL of the page to retrieve. |
| `mode` | string | No | 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. |
| `js_render` | boolean | No | Render the page in a headless browser before returning it. Required for content that only exists after JavaScript runs. |
| `js_instructions` | string | No | JSON array of browser instructions (click, fill, scroll, wait) executed on the page before the content is returned. Requires js_render. |
| `custom_headers` | boolean | No | Forward your own request headers (cookies, referer) to the target. |
| `premium_proxy` | boolean | No | Route the request through residential IPs. Required by most protected sites. |
| `proxy_country` | string | No | Two-letter country code for the exit IP. Requires premium_proxy. |
| `session_id` | integer | No | Reuse the same IP across requests for up to 10 minutes. Any integer you choose identifies the session. |
| `original_status` | boolean | No | Return the target's own HTTP status code instead of the Zenrows one. |
| `allowed_status_codes` | string | No | Comma-separated status codes whose body should be returned instead of raising an error, for example `404,500`. |
| `wait_for` | string | No | CSS selector to wait for before returning. Requires js_render. |
| `wait` | integer | No | Milliseconds to wait after load before returning. Requires js_render. |
| `block_resources` | string | No | Comma-separated resource types to block (for example `image,media,font`). Blocking is on by default. |
| `json_response` | string | No | Return a JSON envelope that also carries the network requests (XHR/fetch) the page made. |
| `css_extractor` | string | No | JSON object mapping output keys to CSS selectors, applied to the retrieved page. |
| `extract` | string | No | 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 |
| `extract_fields` | string | No | 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. |
| `autoparse` | boolean | No | Deprecated in favour of Extract (`extract=auto`). Returns general-purpose JSON parsed from the page, not tailored to the website. |
| `response_type` | string | No | Convert the page before returning it: Markdown, plaintext or PDF. |
| `screenshot` | boolean | No | Return an above-the-fold screenshot of the page. Requires js_render. |
| `screenshot_fullpage` | boolean | No | Return a full-page screenshot. Requires js_render. |
| `screenshot_selector` | string | No | Screenshot only the element matching this CSS selector. Requires js_render. |
| `screenshot_format` | string | No | Screenshot image format. |
| `screenshot_quality` | integer | No | JPEG quality, 1 to 100. Only with screenshot_format=jpeg. |
| `outputs` | string | No | Comma-separated data types to pull out of the retrieved HTML (for example `emails,phone_numbers`). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/","query":{"url":"<string>","mode":"<string>","js_render":"<boolean>","js_instructions":"<string>","custom_headers":"<boolean>","premium_proxy":"<boolean>","proxy_country":"<string>","session_id":"<integer>","original_status":"<boolean>","allowed_status_codes":"<string>","wait_for":"<string>","wait":"<integer>","block_resources":"<string>","json_response":"<string>","css_extractor":"<string>","extract":"<string>","extract_fields":"<string>","autoparse":"<boolean>","response_type":"<string>","screenshot":"<boolean>","screenshot_fullpage":"<boolean>","screenshot_selector":"<string>","screenshot_format":"<string>","screenshot_quality":"<integer>","outputs":"<string>"}}'
```

### Page fetch via PUT

Fetch a page with a PUT: same as Page fetch, but sends a PUT to the target URL and forwards the request body to it as is. All ZenRows options go in the query string.

`PUT /`

**Estimated cost:** from $0.00046 per call (required params only), up to $0.0115; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/zenrows/9c0c5b2e-2904-4690-b282-9e6da7960524

**Docs:** https://docs.zenrows.com/api-reference/fetch/fetch-a-page

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The URL of the page to retrieve. |
| `mode` | string | No | 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. |
| `js_render` | boolean | No | Render the page in a headless browser before returning it. Required for content that only exists after JavaScript runs. |
| `js_instructions` | string | No | JSON array of browser instructions (click, fill, scroll, wait) executed on the page before the content is returned. Requires js_render. |
| `custom_headers` | boolean | No | Forward your own request headers (cookies, referer) to the target. |
| `premium_proxy` | boolean | No | Route the request through residential IPs. Required by most protected sites. |
| `proxy_country` | string | No | Two-letter country code for the exit IP. Requires premium_proxy. |
| `session_id` | integer | No | Reuse the same IP across requests for up to 10 minutes. Any integer you choose identifies the session. |
| `original_status` | boolean | No | Return the target's own HTTP status code instead of the Zenrows one. |
| `allowed_status_codes` | string | No | Comma-separated status codes whose body should be returned instead of raising an error, for example `404,500`. |
| `wait_for` | string | No | CSS selector to wait for before returning. Requires js_render. |
| `wait` | integer | No | Milliseconds to wait after load before returning. Requires js_render. |
| `block_resources` | string | No | Comma-separated resource types to block (for example `image,media,font`). Blocking is on by default. |
| `json_response` | string | No | Return a JSON envelope that also carries the network requests (XHR/fetch) the page made. |
| `css_extractor` | string | No | JSON object mapping output keys to CSS selectors, applied to the retrieved page. |
| `extract` | string | No | 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 |
| `extract_fields` | string | No | 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. |
| `autoparse` | boolean | No | Deprecated in favour of Extract (`extract=auto`). Returns general-purpose JSON parsed from the page, not tailored to the website. |
| `response_type` | string | No | Convert the page before returning it: Markdown, plaintext or PDF. |
| `screenshot` | boolean | No | Return an above-the-fold screenshot of the page. Requires js_render. |
| `screenshot_fullpage` | boolean | No | Return a full-page screenshot. Requires js_render. |
| `screenshot_selector` | string | No | Screenshot only the element matching this CSS selector. Requires js_render. |
| `screenshot_format` | string | No | Screenshot image format. |
| `screenshot_quality` | integer | No | JPEG quality, 1 to 100. Only with screenshot_format=jpeg. |
| `outputs` | string | No | Comma-separated data types to pull out of the retrieved HTML (for example `emails,phone_numbers`). |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/","method":"PUT","query":{"url":"<string>","mode":"<string>","js_render":"<boolean>","js_instructions":"<string>","custom_headers":"<boolean>","premium_proxy":"<boolean>","proxy_country":"<string>","session_id":"<integer>","original_status":"<boolean>","allowed_status_codes":"<string>","wait_for":"<string>","wait":"<integer>","block_resources":"<string>","json_response":"<string>","css_extractor":"<string>","extract":"<string>","extract_fields":"<string>","autoparse":"<boolean>","response_type":"<string>","screenshot":"<boolean>","screenshot_fullpage":"<boolean>","screenshot_selector":"<string>","screenshot_format":"<string>","screenshot_quality":"<integer>","outputs":"<string>"}}'
```

### Extract domain list

List the domains Extract serves: the websites for which extract=auto/native/standard returns structured JSON. Costs no credits.

`GET /extract/domains`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/zenrows/01cbc258-89b7-4583-8c12-3c7f3dc906cc

**Docs:** https://docs.zenrows.com/extract/endpoints

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/extract/domains","method":"GET"}'
```

### Crawl start

Start a crawl: collect the URLs (and optionally HTML) behind one start URL on its domain. Returns at once with the crawl and its crawl_id; each page it opens is a Fetch request in Adaptive Stealth Mode. max_pages caps the pages fetched.

`POST /crawls`

**Estimated cost:** from $0.0115 per call (required params only), up to $1149.95; use `"dryRun": true` in the Run API request to check the exact cost before calling.

**Page:** https://www.orthogonal.com/api/zenrows/651917a3-cc09-46fc-a67e-7b305d28f023

**Docs:** https://docs.zenrows.com/crawl/endpoints

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The start URL: a public `http` or `https` URL. The crawl starts on this exact URL and stays on its domain, subdomains included. |
| `depth` | integer | No | How many link steps to follow from the start URL. At `1`, the links on the start page. Omit it to follow links until `max_items` or `max_pages` stops the crawl. |
| `max_items` | integer | No | Stop after keeping this many URLs. |
| `max_pages` | integer | No | Stop after fetching this many pages. Caps what the crawl costs. If both limits are reached together, `stop_reason` is `max_pages`. |
| `include_patterns` | string | No | Keep, and open, only URLs that contain at least one of these texts, such as `/product/`. The start URL is never returned. |
| `exclude_patterns` | string | No | Drop URLs that contain any of these texts, even when they match an include pattern. |
| `output_format` | string | No | `html` also returns the HTML of each kept page. Omit it to get URLs only. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/crawls","body":{"url":"<string>","depth":"<integer>","max_items":"<integer>","max_pages":"<integer>","include_patterns":"<string>","exclude_patterns":"<string>","output_format":"<string>"}}'
```

### Crawl status and results

Read a crawl and its results by the crawl_id that Crawl start returned, a page of results at a time.

`GET /crawls/{crawl_id}`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/zenrows/5496a01c-f80f-496c-9de1-e00603a96481

**Docs:** https://docs.zenrows.com/crawl/endpoints

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `crawl_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `cursor` | string | No | The `next_cursor` from the previous read. Omit it to start from the first result. |
| `limit` | integer | No | How many results to return. |

```bash
# Replace {crawl_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/crawls/{crawl_id}","method":"GET","query":{"cursor":"<string>","limit":"<integer>"}}'
```

### Crawl results download

Download all results of a crawl in one file, by its crawl_id.

`GET /crawls/{crawl_id}/download`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/zenrows/ce71889a-9645-4ac5-8fcc-b9df1cde5b72

**Docs:** https://docs.zenrows.com/crawl/endpoints

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `crawl_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {crawl_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/crawls/{crawl_id}/download","method":"GET"}'
```

### Crawled page HTML

Read one crawled page's HTML, by the crawl_id and the content_id listed in the crawl's results (crawls started with output_format=html).

`GET /crawls/{crawl_id}/contents/{content_id}`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/zenrows/35fce55f-bdfa-4e75-ab75-063e264b6f6d

**Docs:** https://docs.zenrows.com/crawl/endpoints

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `crawl_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `content_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `download` | boolean | No | `true` returns the page as a file to save. |

```bash
# Replace {crawl_id}, {content_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/crawls/{crawl_id}/contents/{content_id}","method":"GET","query":{"download":"<boolean>"}}'
```

### Crawl stop

Stop a running crawl by its crawl_id. No new page is fetched after the stop; pages already being fetched finish and stay in the crawl.

`POST /crawls/{crawl_id}/stop`

**Cost:** Free

**Page:** https://www.orthogonal.com/api/zenrows/29628d8c-9aac-4aa5-bea6-02c9fe407178

**Docs:** https://docs.zenrows.com/crawl/endpoints

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `crawl_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {crawl_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"zenrows","path":"/crawls/{crawl_id}/stop"}'
```

---

Full details and an interactive quickstart: https://www.orthogonal.com/publisher/zenrows
