VOOZH about

URL: https://alterlab.io/docs/sdk


SDKv2.0.0

Official SDKs

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

Quick Comparison

FeaturePythonNode.js
Packagepip install alterlabnpm install @alterlab/sdk
RuntimePython 3.8+Node.js 18+
Type SafetyType hints + mypyFull TypeScript
Async SupportAsyncAlterLab clientNative async/await
DependencieshttpxNone (native fetch)
SourceGitHubGitHub

Installation

Bash
# Using pippip install alterlab

# Using poetrypoetry add alterlab

# Using pipenvpipenv install alterlab

Quick Start

Python
from alterlab import AlterLab

# Initialize clientclient = AlterLab(api_key="sk_live_...")# or set ALTERLAB_API_KEY env var
# Scrape a websiteresult = client.scrape("https://example.com")print(result.text)# Extracted textprint(result.json)# Structured JSONprint(result.billing.cost_dollars)# Cost breakdown
# With JavaScript renderingresult = 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.
TierNamePricePer $1Use Case
1Curl$0.00025,000Static HTML sites
2HTTP$0.00033,333TLS fingerprinting
3Stealth$0.002500Browser checks
4Browser$0.004250JS-heavy SPAs
5Captcha$0.0250CAPTCHA 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!