API Changelog
A running log of changes to the AlterLab API. New endpoints, breaking changes, improvements, and fixes.
Versioning Policy
/api/v1/). Breaking changes get a 90-day deprecation window. See the API Versioning Policy for details.Latest Changes
Advanced stealth capabilities
We have upgraded our anti-detection engines to simulate human interactions like mouse movements and scrolling during fast requests. Fingerprint masking was also strengthened to ensure your scrapes pas...
Consistent session IP routing
Browser scraping sessions now maintain a single, sticky IP address throughout the entire page lifecycle. This prevents mid-session network changes that frequently trigger security challenges or correl...
Higher scraping success rates
We optimized how our platform allocates resources and manages connection timeouts during heavy scraping workloads. Your requests will now also automatically retry in the background if transient infras...
Handling of slow-loading pages
Extremely slow websites that exceed maximum navigation timeouts will no longer fail your entire request instantly. The API will now gracefully attempt to return whatever HTML successfully loaded befor...
Exactly-once job processing
We eliminated a backend race condition that could cause a scraping job to execute multiple times if a server experienced a sudden restart. Jobs are now strictly guaranteed to process exactly once, sav...
Standardized empty API responses
API endpoints designed to return empty HTTP responses have been updated to perfectly align with strict standard validation rules. This ensures seamless compatibility with automated SDK generators and ...
Reliable payment method selection
Setting a default payment method in your billing dashboard is now handled as a single atomic operation. This prevents the creation of duplicate default entries when multiple update requests are sent s...
Support ticket search stability
Searching your administrative support tickets with an empty query will no longer result in an unexpected server error. The platform now gracefully catches empty search strings and prompts for valid in...
Enhanced data access security
We implemented stricter parameter validation and ownership verification across our billing and job management systems. These upgrades provide robust protection against unauthorized cross-account acces...
General bug fixes and improvements
Plus 28 internal improvements for better reliability and performance.
Restored Extraction Schema Access
Resolved an issue where structured extraction requests incorrectly required custom AI provider keys across single, batch, and crawl API endpoints. You can once again use standard extraction schemas wi...
Billing Deposits API Recovery
Fixed a server error that occasionally prevented users from accessing their billing deposits through the API. Developers can now reliably fetch their complete account transaction history without unexp...
Secure URL Upgrades
Improved URL normalization when automatically forcing secure connections on standard web addresses. This prevents target URLs from retaining outdated port numbers, ensuring more reliable scraping outc...
General bug fixes and improvements
Plus 1 internal improvement for better reliability and performance.
Invoice API Resolution
Resolved an issue that temporarily prevented the retrieval of billing invoices via the API. You can now reliably access your complete billing history without encountering unexpected errors.
Manage beta features via SDK
You can now programmatically opt-in and manage beta feature enrollments directly through the Node and Python SDKs. This ensures your automated workflows can test cutting-edge capabilities without manu...
Extraction models in Node SDK
We have added native support for specifying extraction models and providers directly within the Node SDK. You can now seamlessly route your scrape, extract, and crawl requests to the language model of...
Expanded SDK formatting options
Both the Node and Python SDKs now fully support all available output formats, including RAG, raw, and JSON v2. We also added full type support for extraction metadata to improve your IDE autocomplete ...
Comprehensive OpenAPI spec update
Our public OpenAPI specification has been fully synchronized with the latest platform enhancements. You can now reliably generate clients for all recent extraction, billing, and dashboard management e...
High-accuracy extraction cache matching
We resolved an issue where long documents with identical starting text could trigger incorrect cache hits. The extraction cache now evaluates the entirety of your content to guarantee perfectly accura...
Deep Crawl Reliability Restored
Resolved an issue that occasionally caused multi-page scraping tasks to become permanently stuck. These deep crawls will now reliably recover and finish even during internal system interruptions.
Expanded Global Retail Support
You can now access data from 11 additional regional domains across Europe, the Middle East, and the Americas. Enhanced geographic routing ensures you receive localized content and accurate pricing for...
Enhanced Security Challenge Bypassing
Requests targeting sites with advanced security challenges now have more time to complete background verification steps. Automatic page refreshing ensures you are served the final content immediately ...
Higher System Reliability
We optimized how site-specific analytics are handled to eliminate internal bottlenecks and reduce processing delays. This ensures consistent API performance and dashboard responsiveness during large-s...
Reliable Session Visualizations
We resolved an issue that caused session recordings of large web pages to appear blank. You can now reliably review full-page captures for debugging, regardless of the complexity or size of the target...
General bug fixes and improvements
Plus 3 internal improvements for better reliability and performance.
Reliable HTML result storage
Resolved an issue that could prevent the platform from successfully saving scraped HTML responses at the beginning of a new day. Your scrape results are now reliably captured and stored without interr...
General bug fixes and improvements
Plus 1 internal improvement for better reliability and performance.
Broader advanced evasion support
Scraping requests now consistently apply our most advanced evasion capabilities across all domains. This significantly reduces blocks and improves overall success rates on highly protected websites.
Accurate routing in failure logs
Failed requests now accurately report the execution path used rather than displaying an unknown state. This provides clearer visibility into how your requests were routed and simplifies debugging.
General improvements
This release includes general improvements and maintenance updates.
Enforced spend limits for browser scrapes
Advanced browser scraping requests now accurately reserve against your daily budget limits before execution. This prevents accidental overages when running many concurrent high-resource requests.
Reliable partial refunds processing
Multiple partial refunds applied to a single transaction now process successfully without skipping. Your account ledger will accurately reflect all individual refund amounts as they occur.
Multi-tab promotional code redemption
Applying a promotional code while having multiple billing tabs open will no longer cause checkout sessions to conflict or fail. Your selected promotion will apply cleanly to your active payment sessio...
Automated dispute balance reconciliation
Your account balance now immediately synchronizes when a bank dispute or external refund is initiated. This ensures your available credits always reflect the true, up-to-date state of your transaction...
Next-Generation Anti-Bot Bypass
We've completely overhauled our bypass engine to successfully navigate the most advanced JavaScript and browser integrity challenges. You will see significantly higher success rates and fewer blocks w...
Faster Empty Response Handling
Legitimate target endpoints that return small JSON payloads or empty successful responses no longer trigger unnecessary retry loops. These requests now return immediately, saving you time and preventi...
Accurate Empty Scrape Analytics
Scrapes that intentionally return empty content are now correctly classified as successful in your dashboard analytics. Previously, these were sometimes misreported as failures, which artificially ske...
Restored Batch API Access
We resolved multiple backend and authentication issues preventing users on standard plans from submitting batch scraping jobs. Batch job submissions are now fully operational when triggered via both t...
Robust Markdown Extraction
The markdown extraction engine no longer incorrectly removes main page content when parsing sites with certain generic CSS classes. You will now receive complete and accurate markdown text for a wider...
Improved table data extraction
Fixed an issue where data tables on certain websites were incorrectly omitted from parsed results. The extraction engine now properly preserves tabular data even when it is nested inside form elements...
General bug fixes and improvements
Plus 10 behind-the-scenes improvements for better reliability and performance.
General improvements
This release includes general improvements and maintenance updates.
General bug fixes and improvements
Plus 3 behind-the-scenes improvements for better reliability and performance.
Reliable past invoice downloads
You can now reliably download all past invoices directly from your billing dashboard. We resolved an issue where older receipt links would expire, ensuring permanent access to your financial records.
Enhanced background task stability
We resolved infrastructure issues that previously caused interruptions for background tasks and file downloads. Core services are now more resilient during system updates, ensuring consistent uptime.
Faster billing invoice history
We optimized how invoice data is retrieved, making the billing endpoints and dashboard pages load significantly faster. You can now access your payment history without experiencing long loading times.
How to Stay Updated
Check this page for a summary of all API changes with each release.
Visit the full changelog for a detailed, filterable timeline of all product updates including frontend and infrastructure changes.
Watch for deprecation headers in API responses. Deprecated endpoints return a Sunset header with the removal date.
Change Types
| Type | Description | Action Required? |
|---|---|---|
| New | New endpoints, parameters, response fields, or SDK methods | No |
| Improved | Performance improvements, better error messages, enhanced behavior | No |
| Fixed | Bug fixes, corrected behavior, resolved edge cases | No |
| Security | Security patches and vulnerability fixes | Review recommended |
| Breaking | Removed fields, changed types, removed endpoints (announced 90+ days in advance) | Yes - update your code |
Full Changelog
For a complete, filterable timeline of all AlterLab updates including frontend changes, infrastructure improvements, and more, visit the full changelog.
View Full Changelog