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
Installation
# Using pip
pip install alterlab
# Using poetry
poetry add alterlab
# Using pipenv
pipenv install alterlab# Using npm
npm install alterlab
# Using yarn
yarn add alterlab
# Using pnpm
pnpm add alterlabQuick Start
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)Pricing
$1 = 5,000 Scrapes
Pay-as-you-go pricing with no subscriptions. The API automatically escalates through tiers until successful, charging only for the tier used.
| 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!