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
Preserve Custom Session Cookie Metadata
Your custom session cookies now retain their full security and scope attributes when requests are retried through browser rendering. This maintains session integrity and prevents unexpected logouts or...
Geotargeting Preserved on Proxy Rotation
Requests that automatically rotate proxies after encountering a block now strictly retain your requested country targeting. This prevents requests from falling back to default regions when a proxy swa...
Persistent Clearance Sessions
Successfully solved clearance tokens from detection systems are now seamlessly carried over to subsequent request attempts. This reduces repeated challenges, resulting in faster load times and higher ...
Credentials Kept on Redirects
Authenticated GET requests that undergo same-origin redirects now reliably retain their authorization credentials. This ensures you do not receive unexpected 401 errors or public fallbacks during redi...
Accurate Bring-Your-Own-Proxy Billing
Your custom proxies now maintain their correct classification during reactive proxy switches. This guarantees accurate pricing and prevents billing inaccuracies for requests using your own proxy pools...
Reliable Proxy Enforcement for Deferred Requests
Delayed or queued scraping tasks now strictly preserve their proxy requirements when resumed. This ensures requests never bypass designated proxies and fail closed if the required proxy is unavailable...
Accurate Error Reporting for Retries
When retrying requests through our browser rendering system, failed target website status codes are now correctly propagated. This prevents unsuccessful scrapes from being reported as successful.
Accurate Proxy Error Reporting
The API now reports the exact, final error reason when a proxy connection fails, clearing out outdated intermediate exceptions. This simplifies debugging and helps you implement more precise error han...
Reliable Organization Dashboard Analytics
Resolved SQL data-type errors that caused organization-scoped analytics charts to fail on the developer dashboard. Your metrics and usage breakdowns will now load reliably.
Secure Header Delivery on Retries
Your custom authentication, API, CSRF, and idempotency headers are now securely forwarded to target sites during retries. This ensures authenticated requests succeed without exposing headers globally.
Strict Leak Prevention on Proxy Failure
Requests requiring proxies will now fail closed rather than falling back to unproxied connections if proxy rotation fails. This guarantees your actual IP address is never leaked or exposed to the targ...
General bug fixes and improvements
Plus 10 internal improvements for better reliability and performance.
Smarter IP Network Routing
The platform now uses real-time network reputation data to select the cleanest connection routes. By avoiding failing network paths, your scrapers will experience higher reliability and fewer IP block...
In-Place Security Challenge Solving
The scraper now handles verification challenges that resolve in-place via dynamic page updates. This ensures successful data extraction from highly protected sites without requiring full-page reloads.
Smarter Scrape Result Caching
The cache engine now records your exact proxy choices when saving successful results. This prevents cached proxied responses from being mistakenly returned to subsequent direct requests.
Consistent Proxy Intent in SDKs
The SDKs and batch endpoints now correctly distinguish between omitting proxy options and setting them to false. This restores full control, letting you safely utilize automatic system proxies.
Automatic Proxy Escalation Fixed
We resolved a routing bug where omitting the proxy option was treated as a direct request. This allows the API to automatically escalate and route requests through system proxies when facing page bloc...
Forced JavaScript Rendering Preserved
Explicit requests for JavaScript rendering are now strictly honored and will not be overridden. This guarantees that your dynamic pages are always fully rendered using a browser engine when specified.
Accurate Challenge Solving Metrics
We resolved an issue where the API could occasionally report success while a verification challenge was still active. The system now verifies that the target content has fully loaded before returning ...
Proxy Safety for Dedicated Paths
Geotargeting and sticky session settings are now strictly preserved across specialized rendering tasks. The API will also fail closed if a secure route lacks a configured proxy to prevent data leaks.
General bug fixes and improvements
Plus 4 internal improvements for better reliability and performance.
Reliable JavaScript Requests
JavaScript-rendered scraping requests now experience significantly higher success rates. We optimized routing workflows to ensure consistent and reliable delivery of dynamic web content.
Resilient Redirect Recovery
Scraping tasks involving web redirects are now more resilient to network fluctuations. The API recovers faster to ensure target pages are reached successfully without losing connection.
General bug fixes and improvements
This release includes 1 internal improvements for better reliability and performance.
Unified PAYG Balance Tiers
Funded Pay-As-You-Go accounts are now automatically scaled to their correct billing-tier benefits across all platforms. You can now access advanced limits and features instantly in Workflow Studio, us...
Synchronized SDK Usage Tracking
Both the Python and Node SDK client libraries have been fully synchronized with our latest OpenAPI specifications. This enables accurate auto-generated type definitions, updated documentation, and sea...
Real-Time Parallel Crawling Safeguards
The platform now evaluates real-time available balances and limits before distributing massive parallel scrape jobs. This ensures predictable scaling behavior and protects your account from unexpected...
Instant Workspace Access Revocation
Hardened security boundaries now immediately invalidate user-owned API keys when a member is removed from an organization. This prevents unauthorized calls by instantly flushing all active authorizati...
Personal Workspace Privacy Controls
Invited workspace members can no longer view the private billing tiers and usage analytics of a personal workspace owner. Enterprise-level organizational analytics remain fully functional and unaffect...
Multi-Workspace Billing Scoping
Usage estimates, ledger summaries, auto-recharge rules, and billing charts are now strictly scoped to your selected workspace organization. This prevents aggregate billing data from mixing together ac...
Unified Organization Deposits
Customer deposit checkouts are now correctly mapped to the organization's primary billing principal rather than individual members. This guarantees clean invoice records and correct checkout ownership...
Restored Usage Log Visibility
Dashboard statistics and detailed run logs now accurately show API consumption handled on behalf of the organization's billing owner. This restores real-time tracking transparency for developers monit...
Instant Owner Role Resolution
Ownership changes for organizations are now reflected immediately across authorization layers instead of relying on outdated caching. New billing administrators can immediately manage budgets and subs...
Reliable JavaScript-Rendered Routing
Fixed an issue where enabling JavaScript rendering could bypass optimal proxy configurations on specific target pages. Your interactive scrapes will now consistently route through high-success paths.
Node SDK Signature Parsing
Resolves verification errors in the Node SDK when processing configurations containing nested template literals. You can now use dynamic values in your request schemas without encountering signature m...
n8n Automation Flow Stability
Corrected a credential-derived URL normalization bug that affected asynchronous polling inside the n8n runtime environment. Workflow nodes can now poll progress securely without facing unexpected auth...
General Bug Fixes and Improvements
Standardized error responses during crawl validation to match expected formats, ensuring more predictable debugging. Historical balance reconciliation records were also corrected to guarantee perfect ...
General improvements
This release includes general improvements and maintenance updates.
Flexible sync deadlines
Configure your API calls to remain open until a specific deadline is met. This ensures you get scraped data in the initial response and eliminates unnecessary polling.
Smarter detection system bypasses
Scraping websites with advanced detection systems is now much more stable. The system preserves bypass strategies after resets, preventing unexpected failures on highly secured domains.
Passive security widget handling
Scraping pages with passive security widgets is now highly reliable. Our engine accurately distinguishes passive elements from active, blocking challenges to ensure smooth data extraction.
Granular browser error messages
Get detailed, actionable error messages if a browser session fails to launch. The API distinguishes concurrency limits from initialization timeouts so you can optimize scaling.
Fair billing for failed scrapes
You will no longer be billed for failed scrapes that return terminal HTML error pages. Our platform detects these bad responses early and filters them out before charging your ledger.
Automated ledger reconciliation
Our billing system now automatically reconciles failed jobs against your account ledger. This ensures that any debits for failed jobs or tier upgrades are fully and safely refunded.
Consistent job polling URLs
Every asynchronous scrape now includes a consistent job polling URL in its response. This guarantees seamless tracking for all edge cases, including timeouts and automatic downgrades.
Robust third-party authentication
Enjoy more reliable and secure session persistence across your API integrations. Logging in via third-party one-tap authentication providers is now highly stable across all gateways.
Graceful documentation link redirects
All legacy documentation links have been permanently mapped to their modern canonical routes. You can now navigate reference guides smoothly without encountering broken URLs.
General bug fixes and improvements
Plus 4 internal improvements for better reliability and performance.
Continuous Task Queue Reliability
We fixed a bug that could cause scraping tasks to permanently stop processing during extended, multi-day operations. Your pipelines will now process high-volume request queues continuously and reliabl...
deployment recovery CI contracts
- mark the new command-target deployment tests executable.
Fail closed production deployment recovery
- normalize container dotenv through a non-evaluating renderer before production shell consumers load it.
Decode quoted production dotenv escapes
Decode valid quoted dotenv escapes exposed by production.
General improvements
This release includes general improvements and maintenance updates.
Reliable third-party sign-in flows
We modernized the secure data handoff during sign-ins. This eliminates transient authentication errors and ensures a seamless, reliable login experience.
General bug fixes and improvements
Plus 1 internal improvement for better reliability and performance.
Instant Revocation of Expired Sessions
Active sessions are now immediately terminated and blocked the moment they are revoked. This prevents any unauthorized access to your dashboard or API keys using expired session tokens.
General improvements
This release includes general improvements and maintenance updates.
Enhanced Scraping Reliability
The scraping engine now automatically detects blocked requests and reroutes them through clean IPs. This ensures your scrapes succeed reliably without interrupting interactive solver flows.
Fixed Announcement Bar Layout
We fixed a dashboard layout bug that displayed a blank 45px space. Promotional banners now display correctly, while critical maintenance alerts remain prioritized.
Graceful Session Expiration Handling
API requests with expired sessions now receive a structured error response for easier programmatic handling. Dashboard users are gracefully redirected to log in while keeping their current path.
General bug fixes and improvements
This release includes 2 internal improvements for better reliability and performance.
Durable crawl credit refunds
Scheduled crawl refunds are now durable and spend counters are settled with stable idempotency keys. This ensures you are never double-charged and failed scheduler credits are correctly refunded.
Reliable recurring crawl auth
The resolved billing identity is now persistently used for recurring crawl schedules. This prevents auth timeouts and ensures your scheduled tasks execute reliably.
Preserved crawl budget reservations
Your scheduled crawl budget reservations are now safely preserved when revalidating custom proxy credentials. This ensures validation checks do not block or discard active crawl allocations.
Robust profile ad validation
We have introduced automated retries and terminal status handling to paired profile ad validation. This prevents validation checks from hanging and improves success rates for active ad profiles.
Typed batch scraping responses
The Node SDK now fully exposes accepted and rejected task details for bulk scraping. This provides complete TypeScript compile-time safety when inspecting the results of your batch operations.
Documented batch response schemas
The OpenAPI schema now formally defines the terminal HTTP 200 response body for batch scraping requests. This simplifies custom client generation and bulk request integration.
Enhanced TypeScript type discovery
The Node SDK now successfully detects and parses inline or intersection generic types inside raw request helper calls. This ensures your custom type definitions are correctly captured during developme...
No debits for denied runs
Credit entitlement checks are now performed before charging balances for scheduled scraping tasks. This ensures you are never charged for a scheduled run that gets denied or blocked during pre-dispatc...
Reliable scraping task cancellation
Task cancellations are now properly preserved and raised during background billing retry cycles. This ensures that stopped scraping requests immediately cease processing and do not consume your resour...
Accurate concurrent refund tracking
A concurrency lock has been introduced to prevent concurrent refund replays from overwriting newer balance updates. This ensures your account credit balances remain perfectly accurate and synchronized...
Robust batch payload validation
The batch endpoint now gracefully validates and rejects non-object JSON inputs before queue processing. This prevents malformed bulk requests from stalling or halting execution pipelines.
Secure browser profile isolation
Access restrictions have been tightened to block external access to browser profile directories within served downloads. This secures session-specific data and prevents potential cross-tenant leakage.
General bug fixes and improvements
Plus 9 internal improvements for better reliability and performance.
Redesigned Authentication Pages
Enjoy a modern, beautiful split-screen sign-in and sign-up experience. The site header now points directly to this redesigned signup page, getting you up and running faster.
Interactive Search Playground
Test-drive real search requests directly in the playground before signing up. We also streamlined the interface by replacing manual engine selection with smart automatic routing.
Attributed Lead Opportunity Queue
Discover high-value scraping opportunities automatically with our new Lead Opportunity Queue. This feature aggregates discovery signals into a stable, verified queue with detailed lifecycle tracking.
Verified Social Media Dispatch
Our API now actively verifies that automated submissions on platforms like Reddit and Stack Overflow are live. This guarantees you always receive accurate publication status without manual polling.
Automated Blog Syndication States
Get precise visibility into your content syndication workflows. Separate states for attempts, publication, and verification ensure your content is never double-posted or lost.
Instant Search Failover
Our search API now triggers failover mechanisms immediately when encountering thin or empty results instead of waiting for a timeout. This dynamic escalation drastically reduces total latency.
Efficient Rate-Limit Queueing
Rate-limit reservations are now safely preserved across job deferrals in your scraping queues. This ensures delayed jobs retain their slots, preventing unnecessary API throttling.
Streamlined Batch Rejection
Fully rejected batch requests now return a terminal HTTP 200 response immediately instead of creating a polling resource. This reduces client polling overhead and speeds up error handling.
Zero-CLS Desktop Layouts
We eliminated Cumulative Layout Shift (CLS) on desktop browsers by reserving layout space for the announcement bar. Page elements no longer shift unexpectedly during asynchronous loads.
Deduplicated Initial Scrapes
We resolved an issue where running a scrape on landing pages could trigger duplicate requests or double-billing on navigation. A secure local storage marker now deduplicates initial loads.
Search Reliability Enhancements
We resolved a routing anomaly that caused search requests to occasionally be flagged as automated traffic. By adjusting request parameters, we have boosted success rates on Google queries.
Enhanced B2B Payload Privacy
We hardened B2B demographic proof endpoints by stripping internal proxy details, such as raw exit IPs and unhashed proxy credentials. All sensitive fields are now properly hashed.
Protected Login Redirects
We resolved an open-redirect vulnerability where the post-login callback query parameter could bypass our origin policy. Callback URLs are now strictly sanitized before redirection.
Plaintext Credential Prevention
Our profiling backend now automatically redacts credential-like substrings before persisting error logs to the database. This guarantees that your sensitive keys remain protected.
General bug fixes and improvements
Plus 27 internal improvements for better reliability and performance.
Clearer Domain Error Messages
We updated customer-facing error messages to provide clearer, actionable troubleshooting feedback when domains block requests. Misleading alerts claiming a domain cannot be scraped have been removed.
Smarter IP Block Classification
Our API error categorization is now more granular and distinguishes IP reputation blocks from standard page verification challenges. This allows for more precise routing and proxy rotation strategies.
AI Model Failover Reliability
We enhanced structured data extraction reliability by immediately demoting AI models that encounter parsing failures. The system will seamlessly fall back to another model to prevent empty responses.
Faster Proxy Integration Endpoints
We optimized database connection lifetimes across our proxy integration management endpoints. Releasing active connections before executing outbound calls prevents saturation and speeds up response ti...
SDK Sync-Downgrade Polling Resilience
Both developer SDKs now automatically handle server-side sync-downgrade 202 responses during timeout events. Instead of throwing errors, the SDKs will smoothly transition to polling status updates.
Add-on Retry Billing Correction
We corrected the billing reconciliation logic for screenshot and PDF add-on jobs during automated retries. This ensures you are billed accurately only when initially failed add-ons successfully resolv...
General bug fixes and improvements
Plus 43 internal improvements for better reliability and performance.
General improvements
This release includes general improvements and maintenance updates.
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