Setup and compatibility
What Node.js versions does the SDK support?
What Node.js versions does the SDK support?
Node.js 20 and later, per the package’s
engines field. The SDK has two dependencies, fastq and fetch-retry, installed automatically with npm install zenrows.Does the SDK work with both CommonJS and ES modules?
Does the SDK work with both CommonJS and ES modules?
Yes.
package.json exposes both a CommonJS build (require("zenrows")) and an ES module build (import { ZenRows } from "zenrows"), plus TypeScript types.Does the SDK support Proxy Mode?
Does the SDK support Proxy Mode?
No. The SDK talks to the Universal Scraper API’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 rather than the SDK.
Requests, errors, and concurrency
Does the SDK support PUT or DELETE requests?
Does the SDK support PUT or DELETE requests?
No. Only
get() and post() are exposed. See Sending a PUT request for a workaround using native fetch.Why isn't my request throwing an exception on failure?
Why isn't my request throwing an exception on failure?
By design, the SDK resolves with the
Response object even for non-2xx status codes, matching native fetch behavior. Check response.ok or response.status yourself. See Error Handling and Retries.Why doesn't a 429 get retried automatically?
Why doesn't a 429 get retried automatically?
The Node.js SDK’s built-in retry logic only covers
422, 503, 504, and network errors, not 429 or 500/502. Lower your concurrency or add your own backoff for rate-limit errors. See Concurrency.Project and support
Is there a Python version of the SDK?
Is there a Python version of the SDK?
Yes. See the ZenRows Python SDK on PyPI, which additionally supports
put() and explicit async methods.Where can I see the SDK's source code or report a bug?
Where can I see the SDK's source code or report a bug?
The SDK is open source on GitHub. Open an issue there for bugs, or a pull request if you’d like to contribute.
What license is the SDK released under?
What license is the SDK released under?
MIT. You can use, modify, and distribute it freely; see the LICENSE file in the repository.
Still stuck?
Check the API Error Codes reference, or contact support directly.