> ## 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`.

# Frequently Asked Questions

> Answers to common questions about the Zenrows Python SDK.

### Setup and compatibility

> [accordion] What Python versions does the SDK support?
>
> Python 3.6 and later. The SDK has no other runtime dependencies beyond `requests` and `urllib3`, which are installed automatically with `pip install zenrows`.

> [accordion] Do I need to install requests separately?
>
> No. `requests` (and `urllib3`) are installed automatically as dependencies when you run `pip install zenrows`.

> [accordion] Does the SDK support Proxy Mode?
>
> No. The SDK talks to Fetch's endpoint directly (API Mode). If you want to use Zenrows as a proxy in your own HTTP client instead, see the [Proxy Mode documentation](https://docs.zenrows.com/fetch/setup.md#connection-modes) rather than the SDK.

### Requests, errors, and concurrency

> [accordion] How do I set a request timeout?
>
> Pass `timeout` as an extra keyword argument to `get`, `post`, or `put`. It's forwarded to the underlying `requests` call: `client.get(url, timeout=30)`. We recommend not setting a timeout below 3 minutes, since canceling a request client-side doesn't immediately free up the concurrency slot on Zenrows' side.

> [accordion] Why isn't my request raising an exception on failure?
>
> By design, the SDK returns the `requests.Response` object even for non-2xx status codes. It doesn't raise automatically. Check `response.ok` or `response.status_code`, or call `response.raise_for_status()` yourself if you want an exception. See [Error Handling and Retries](https://docs.zenrows.com/fetch/sdk/python/error-handling-and-retries.md).

> [accordion] Can two scripts share the same concurrency limit?
>
> No. Each `ZenRowsClient` instance enforces its own `concurrency` setting independently. Running two scripts (or two client instances) at the same time can exceed your plan's actual limit and trigger `429 Too Many Requests` errors. Coordinate concurrency across processes yourself if you run multiple scripts against the same Zenrows plan.

### Project and support

> [accordion] Is there a Node.js version of the SDK?
>
> Yes. See the [Zenrows Node.js SDK](https://www.npmjs.com/package/zenrows) on npm.

> [accordion] Where can I see the SDK's source code or report a bug?
>
> The SDK is open source on [GitHub](https://github.com/ZenRows/zenrows-python-sdk). Open an issue there for bugs, or a pull request if you'd like to contribute.

> [accordion] What license is the SDK released under?
>
> MIT. You can use, modify, and distribute it freely; see the [LICENSE](https://github.com/ZenRows/zenrows-python-sdk/blob/main/LICENSE) file in the repository.

> [card] [Still stuck?](mailto:success@zenrows.com)
>
> Check the [API Error Codes](https://docs.zenrows.com/api-error-codes.md) reference, or contact support directly.


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