Session API
The Session object manages shared configuration across multiple Page, Dataset, Crawl, and Watch operations. It centralizes headers, cookies, proxies, and rate limits.
5 min read Updated July 2026
Python Usage
Node.js Usage
Session Methods
| Method | Parameters | Description |
|---|---|---|
| headers(dict) | Header key-value pairs | Set default HTTP request headers |
| cookies(dict) | Cookie key-value pairs | Set default cookies for requests |
| proxy(url) | Proxy URL string | Set single HTTP/HTTPS proxy |
| proxy_pool(list) | List of proxy URLs | Enable round-robin proxy pool rotation |
| rate_limit(rps) | Requests per second (float) | Per-host rate limiting (0 = disabled) |
| timeout(secs) | Seconds (int) | Set request timeout |
| auto_match(bool) | Boolean | Enable self-healing selector recovery |
| fetcher_tier(tier) | "standard" | "stealthy" | TLS fingerprint emulation level |
Configuration Precedence
Settings are resolved in the following priority order (later steps override earlier ones):
- TOML configuration file (
crawlingo.toml) - Environment variables (
CRAWLINGO_*) - Session constructor options
- Session method calls (e.g.
session.rate_limit(5.0)) - Per-request explicit parameter overrides
