Changelog

Pre-1.0 Disclaimer

scrape-do-python follows Semantic Versioning, but 0.x minor versions may contain breaking changes

Format

The format below is based on Keep a Changelog

---

0.1.1 — 2026-05-09

Added

• Curated public re-exports in scrape_do/__init__.py so common imports work as from scrape_do import ScrapeDoClient, RequestParameters, ... rather than digging into submodules.
• py.typed PEP 561 marker so downstream type-checkers (mypy, pyright) consume the package's type hints.
• Trove classifiers in package metadata — PyPI's "Python" sidebar and shields.io's pypi/pyversions badge now populate correctly.

Removed

• Empty scrape_do/namespaces/ placeholder folder (was scaffolding from before the roadmap solidified; will be replaced by plugins/ in 0.4+).

Documentation

• Planned package layout added to Roadmap

0.1.1

0.1.0 — 2026-05-08

Initial release. Synchronous client surface.

Added

• ScrapeDoClient synchronous client with request(), get(), post(), execute(), and execute_from_url() methods.

• Smart routing in ScrapeDoClient.request(): accepts kwargs, a pre-built RequestParameters, or a raw api.scrape.do URL — exactly one configuration shape per call.

• Automatic retries on Scrape.do gateway errors (429 / 502 / 510) with configurable backoff strategy (static float or Callable). Default is jittered exponential.

• session_validator callback for sticky-session rotation detection — when present and session_id is set, the validator decides whether to raise RotatedSessionError.

• SDK-native event hooks via SyncClientEventHooks TypedDict: request / response / retry lifecycle, distinct from httpx transport-level hooks.

• Pydantic-validated RequestParameters covering the full Scrape.do API parameter surface, including browser-action models.

• ScrapeDoResponse wrapper exposing the parsed JSON envelope, network requests, websocket frames, action results, screenshots, frames, plus a raw status_code passthrough.

• Cookie isolation between sequential requests on the underlying httpx.Client (prevents cross-request bleed).

• Exception hierarchy: ScrapeDoError (base), APIConnectionError, TargetError, RotatedSessionError, plus the API-layer AuthenticationError, BadRequestError, RateLimitError, ServerError, and AuthenticationThrottleError

• Default request timeout raised to 60 seconds (from httpx's 5s default) to accommodate browser rendering and proxy round-trips.

0.1.0