SDKv2.0.0

Official SDKs

Production-ready SDKs for Python and Node.js. Type-safe, well-documented, and battle-tested.

Python SDK

pip install alterlab

Python 3.8+Type HintsAsync/Await

Full-featured async client with type hints, automatic retries, and comprehensive error handling.

Node.js SDK

npm install alterlab

Node.js 18+TypeScriptZero Dependencies

Modern TypeScript SDK with native fetch, full type definitions, and tree-shakeable exports.

Quick Comparison

Feature	Python	Node.js
Package	`pip install alterlab`	`npm install alterlab`
Runtime	Python 3.8+	Node.js 18+
Type Safety	Type hints + mypy	Full TypeScript
Async Support	AsyncAlterLab client	Native async/await
Dependencies	httpx	None (native fetch)
Source	GitHub	GitHub

Installation

Bash

# Using pip
pip install alterlab

# Using poetry
poetry add alterlab

# Using pipenv
pipenv install alterlab

Quick Start

Python

from alterlab import AlterLab

# Initialize client
client = AlterLab(api_key="sk_live_...")  # or set ALTERLAB_API_KEY env var

# Scrape a website
result = client.scrape("https://example.com")
print(result.text)                    # Extracted text
print(result.json)                    # Structured JSON
print(result.billing.cost_dollars)    # Cost breakdown

# With JavaScript rendering
result = client.scrape_js("https://spa-app.com", screenshot=True)
print(result.screenshot_url)

Try in Playground

Pricing

$1 = 5,000 Light requests

Pay-as-you-go pricing with no subscriptions. The API automatically escalates through tiers until successful, charging only for the tier used. New accounts start with up to 5,000 free requests (about 5,000 Light, 500 Protected or 250 Dynamic requests), no credit card required.

Tier	Name	Price	Per $1	Use Case
1	Curl	$0.0002	5,000	Static HTML sites
2	HTTP	$0.0003	3,333	TLS fingerprinting
3	Stealth	$0.002	500	Browser checks
4	Browser	$0.004	250	JS-heavy SPAs
5	Captcha	$0.02	50	CAPTCHA solving

💰 BYOP (Bring Your Own Proxy): Get 20% off when using your own proxy integration!

Features

Anti-Bot Bypass

Automatic tier escalation handles any protection

JavaScript Rendering

Full Playwright browser for SPAs

Structured Extraction

JSON Schema, prompts, and pre-built profiles

Cost Controls

Set budgets, max tiers, and fail-fast options

Caching

Opt-in caching with configurable TTL

Error Handling

Typed exceptions for all error cases

Retry Logic

Automatic retries with exponential backoff

Async Jobs

Long-running scrapes with polling

Open Source

Both SDKs are open source under the MIT license. Star us on GitHub and contribute!

Webhooks Python

Last updated: June 2026