Skip to main content

Confirm

Are you sure?

Changelog · September 27, 2026

Official client libraries for Python, JavaScript, Ruby and Go

The same API in one line of your language, with the retries and error handling already written.

By · Last updated: September 2026

TL;DR

Four official clients are published: urlpipe on PyPI, @urlpipe/sdk on npm, urlpipe on RubyGems and github.com/URLpipe/urlpipe-go. Each waits for the result by default, polls past the 60-second sync window, retries with an Idempotency-Key so a retry never bills twice, types every documented error and verifies webhook signatures. The HTTP API is unchanged and needs none of them.

Free plan, no credit card. 1,000 credits a month.

The clients are thin: one method per endpoint, the API's options passed through as they are, and an extra map for any option newer than the client. They behave identically — the same defaults, the same retry rules, the same error types — because all four are built against one contract.

A call waits for its result: the clients send sync: true, and when a page outlives the sync window they collect it from GET /result/:token themselves. Retries carry an Idempotency-Key generated per call, so a dropped connection is retried without running or billing the work twice.

Packages

Install

One of these
pip install urlpipe
npm install @urlpipe/sdk
gem install urlpipe
go get github.com/URLpipe/urlpipe-go

FAQ

Frequently asked questions

Do I have to use a client library?
No. Every endpoint is one POST with a JSON body, and the code recipes show it with nothing but an HTTP client.
Why is the npm package scoped?
npm refused the unscoped name urlpipe as too close to an existing package, so the JavaScript client is @urlpipe/sdk.
Does a retry cost credits twice?
No. The clients send an Idempotency-Key with every retried request, so the API answers a retry with the first request's result and charge.

Try it on the free plan.

Free plan, no card. Confirm your email and your API key is live — you'll be making real requests in minutes.