unstale

pypi / scrapegraph-py

scrapegraph-py

What changed in scrapegraph-py 1 to 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-12.

6 breaking17 new APIs and options1 behavior and defaults3 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.12 on npm

scrapegraph-py 29 changes

Breaking changes 3

  • HealthResponse.status is narrowed to Literal["ok", "degraded"].

    2.1.1release notes

  • The default API base URL now uses the v2-api host.

    2.0.1release notes

  • Renames SGAI_TIMEOUT_S to SGAI_TIMEOUT.

    2.0.0release notes

New APIs and options 3

Behavior and default changes 1

Fixes and other changes 2

  • A User-Agent header is now sent on every API request.

    2.3.2release notes

  • HealthResponse no longer includes the non-existent services field.

    2.1.1release notes

scrapegraph-py 118 changes

Breaking changes 3

  • The synchronous client was renamed from SyncClient to Client.

    1.0.0release notes

  • Adds infinite scrolling, with scroll configuration simplified to the number_of_scrolls parameter instead of scroll_options.

    1.0.0release notes

  • The local scraper was removed after being merged into smartScraper.

    1.0.0release notes

New APIs and options 14

  • Adds the wait_ms parameter to the Crawler endpoint.

    1.47.0release notes

  • Adds the location_geo_code parameter to SearchScraper.

    1.47.0release notes

  • Adds the time_range parameter to SearchScraper.

    1.47.0release notes

  • Adds the wait_ms parameter to SmartScraper, Scrape, and Markdownify endpoints.

    1.47.0release notes

  • Adds integration for the API and ScrapeGraphAI API.

    1.0.0release notes

  • Adds a crawling endpoint for developers to use.

    1.0.0release notes

  • Adds integration for environment variables and updates environment variable loading.

    1.0.0release notes

  • Adds localScraper functionality; the notes also say it was later merged into smartScraper and removed.

    1.0.0release notes

  • Adds markdownify functionality.

    1.0.0release notes

  • Requests can include optional headers.

    1.0.0release notes

  • Adds support for requests with a schema.

    1.0.0release notes

  • Implements search scraper functionality.

    1.0.0release notes

  • Adds SQL integration.

    1.0.0release notes

  • Adds time-varying timeout support and makes timeout optional.

    1.0.0release notes

Fixes and other changes 1

  • Removes a trailing comma from the headers field in the ScrapeRequest model.

    1.47.0release notes