2.2.0 (2026-09-01)
- Header-based authorization: the client now sends the API key in the
Authorization: Bearer <api_key>request header instead of theapi_keyquery parameter, keeping the key out of URLs and server logs. All API endpoints support header auth (the API continues to accept the query parameter for older SDK versions); no code changes are needed —ScrapingBeeClient(api_key=...)works as before. - All requests now send the
ScrapingBee-Python/<version>User-Agent (previously only HTML API requests did).
- Documented the complete request-parameter list for every API endpoint (HTML, Google Search, Fast Search, Amazon, Walmart, YouTube, ChatGPT, Gemini), including the
tagparameter accepted by all endpoints and deprecated parameters that remain accepted.
2.1.1 (2026-08-06)
- Document Auto-Mode (
mode=auto) support: ScrapingBee picks the cheapest scraping configuration that succeeds and charges only for the winning one. Read the credits charged from theSpb-auto-costresponse header, and optionally cap the cost withmax_cost. No client changes are required — these are pass-through query parameters.
2.1.0 (2026-07-20)
- Added
html_api()method for HTML API with unified GET/POST support - Added
google_search()method for Google Search API - Added
fast_search()method for Fast Search API - Added
amazon_search()method for Amazon Search API - Added
amazon_product()method for Amazon Product API - Added
amazon_pricing()method for Amazon Pricing API - Added
walmart_search()method for Walmart Search API - Added
walmart_product()method for Walmart Product API - Added
youtube_search()method for YouTube Search API - Added
youtube_metadata()method for YouTube Metadata API - Added
youtube_subtitles()method for YouTube Subtitles API - Added
chatgpt()method for ChatGPT API - Added
gemini()method for Gemini API - Added
usage()method for Usage API - Refactored internal
request()method to be API-agnostic
get()andpost()are deprecated in favor ofhtml_api()and will be removed in version 3.0.0.
2.0.2 (2025-10-02)
- Added support for
ai_extract_rulesparameter inSpbParams. - Added Python 3.11 support.
- Dropped Python 3.7 support.
2.0.1 (2023-10-17)
- Fix typos in
README.md(block_ressources->block_resources,json_scenario->js_scenario).
2.0.0 (2023-10-03)
- Properly url encode all params (Thanks to @tuky with PR15).
- No need to url encode params anymore.