> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenrows.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Zenrows HTTP API serves Fetch and Extract (extract=auto) at https://api.zenrows.com/v1/, Crawl at https://api.zenrows.com/v1/crawls, and Batch at https://async.api.zenrows.com/v1. Fetch, Extract, Crawl and Batch are described in OpenAPI 3.1 at https://www.zenrows.com/openapi.json and listed in the RFC 9727 API catalog at https://www.zenrows.com/.well-known/api-catalog. Every endpoint also has its own page under /api-reference with its schema. Use the spec for exact parameter names and types. Crawl's endpoints, parameters and errors are also at https://docs.zenrows.com/crawl/endpoints.md. To call Zenrows from an agent, connect the MCP server at https://mcp.zenrows.com/mcp. To search these docs from an agent, connect the docs MCP server at https://docs.zenrows.com/mcp. Agent skills for Zenrows are published at https://github.com/ZenRows/cli and install with `npx skills add ZenRows/cli`.

# Introduction to the Zenrows Browser

> Learn what the Zenrows Browser offers for dynamic website scraping, including residential proxy rotation, geo-targeting, and CDP support.

The Zenrows Browser (formerly, Scraping Browser) is the perfect solution for effortlessly extracting data from dynamic websites, especially if you're already using tools like Puppeteer or Playwright. **With just one line of code, you can integrate the Zenrows Browser into your existing setup** and immediately benefit from our vast network of over 55 million residential IPs across 190+ countries, offering 99.9% uptime for uninterrupted scraping.

Whether you're dealing with complex JavaScript content or interacting with web elements, Zenrows makes it easy to scrape without worrying about managing proxies or handling dynamic user interactions.

## Ideal for Puppeteer and Playwright Users

If you already have web scraping code using [Puppeteer](https://www.zenrows.com/blog/puppeteer-web-scraping) or [Playwright](https://www.zenrows.com/blog/playwright-scraping), integrating the Zenrows Browser is incredibly simple.

By adding just one line, you can unlock the power of our residential proxy network and browser simulation, without needing to rewrite your entire scraping logic. Zenrows enhances your scraping capabilities with minimal effort:

```bash Browser URL theme={"theme":"css-variables"}
wss://browser.zenrows.com?apikey=YOUR_ZENROWS_API_KEY
```

This integration ensures that your existing scraping operations become more robust, efficient, and scalable.

## Key Advantages

The Zenrows Browser goes beyond traditional scraping techniques, offering solutions for the most challenging web scraping tasks:

* **One Line of Code:** Start scraping instantly with the Zenrows Browser. No complicated setup. Just a simple API call that does all the heavy lifting for you.
* **Dynamic Web Content Extraction:** Many websites rely on JavaScript to display content dynamically. The Zenrows Browser simulates a real user session, allowing you to extract data even from single-page applications (SPAs) or websites that load content asynchronously.
* **Handling User Interactions:** Simulate user actions like clicking, scrolling, or waiting for elements to load, all while avoiding IP blocks and ensuring the data is extracted seamlessly.
* **Geolocation Targeting:** Access localized content by selecting from millions of IPs across 190+ countries, bypassing geo-restrictions to scrape the data you need.
* **IP Auto-Rotation:** Rotate IPs with every request to avoid bans and blocks, ensuring your scraping remains undetected.

## Parameter Overview

Customize your Zenrows Browser requests using the following parameters:

| PARAMETER | TYPE | DEFAULT | DESCRIPTION |
| - | - | - | - |
| **apikey** `required` | `string` | | Your unique API key for authentication |
| [**proxy\_region**](https://docs.zenrows.com/browser-sessions/features/world-region.md) | `string` | `global` | Focus your scraping on a specific geographic region (e.g., eu for Europe). **When set to global, no parameter is needed**. |
| [**proxy\_country**](https://docs.zenrows.com/browser-sessions/features/country.md) | `string` | | Target a specific country for geo-restricted data (e.g., `es` for Spain). Available only when `proxy_region` is set to global. |
| [**session\_ttl**](https://docs.zenrows.com/browser-sessions/features/session-ttl.md) | `number` | `180` | The time to live for the browser session, in seconds. Minimum: 60, Maximum: 900 (1-15 minutes). Defaults to 3 minutes. |

[Sign up free](https://app.zenrows.com/register?p=free)

## Pricing

The Zenrows Browser bills in credits, on the same shared balance as every other Zenrows product. Bandwidth is metered at a flat **25,000 credits per GB** on every plan, plus a flat **5 credits per minute** of session time.

**With Zenrows, you only pay for the data and time you use**, and the Free plan (5,000 credits/month, no credit card required) lets you try it at no cost. Explore our flexible plans and find more details on our [pricing page](https://docs.zenrows.com/first-steps/pricing.md).

## Tips for Optimal Performance

1. **Manage Session Duration**: Keep session durations as short as possible since session time is billed by the minute.

2. **Reuse browser sessions**: For multiple operations on the same site, reuse the browser session rather than creating a new one each time.

3. **Use Proper Page Closure**: Always close pages when done to free up resources:
   ```javascript theme={"theme":"css-variables"}
   // Close individual pages when done
   await page.close();
   ```

4. **Set Reasonable Timeouts**: Use appropriate timeouts for your operations to prevent long-running sessions:
   ```javascript theme={"theme":"css-variables"}
   // Set navigation timeout
   await page.goto(url, { timeout: 30000 });

   // Set selector timeout
   await page.waitForSelector('.element', { timeout: 15000 });
   ```

5. **Optimize Resource Usage**: Block unnecessary resources when they're not needed:
   ```javascript theme={"theme":"css-variables"}
   // Block images, fonts, etc.
   await page.setRequestInterception(true);
   page.on('request', (request) => {
     if (request.resourceType() === 'image' || request.resourceType() === 'font') {
       request.abort();
     } else {
       request.continue();
     }
   });
   ```

6. **Target Specific Countries Wisely**: Only specify a country when needed for your use case, as more specific targeting might have different success rates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.