AlterLabAlterLab
PricingComparePlaygroundBlogDocsChangelog
    AlterLabAlterLab
    PricingComparePlaygroundBlogDocsChangelog
    IntroductionQuickstartInstallationYour First Request
    REST APICrawl APIMap APISearch APISERP APINewExtract APIAIJob PollingAPI KeysSessions APINewEnterprise APIEnterprise
    AccountAutoAlertsAutoAuthAutoBillingAutoCrawlAutoExtractAutoIntegrationsAutoKeysAutoMapAutoMonitorsAutoOrganizationsAutoSchedulesAutoScrapeAutoSearchAutoSessionsAutoUser WebhooksAutoV1 EndpointsAutoWebhooksAuto
    OverviewPythonNode.js
    JavaScript RenderingOutput FormatsPDF & OCRCachingWebhooksJSON Schema FilteringWebSocket Real-TimeBring Your Own ProxyProSticky SessionsProAuthenticated ScrapingNewHTTP Methods & BodiesNewStructured ExtractionAIWeb SearchSite MappingWeb CrawlingBatch ScrapingSchedulerChange DetectionCloud Storage ExportSpend LimitsOrganizations & TeamsAlerts & NotificationsExtraction ProfilesAIBYOK ExtractionAIOAuth2 Machine-to-MachineSupport & TicketsUnsupported Targets
    Structured ExtractionAIE-commerce ScrapingNews MonitoringPrice MonitoringMulti-Page CrawlingMonitoring DashboardAI Agent / MCPMCPAI Research AgentAISite CrawlingData Pipeline to Cloud
    E-commerceLead GenerationChange MonitoringRAG & AI PipelinesAIResearch
    PricingRate LimitsError CodesChangelogVersioning
    From FirecrawlFrom ApifyFrom ScrapingBee / ScraperAPIFrom Crawl4AIFrom SpiderFirecrawl v0 API ReferenceLegacy
    OverviewMCP ServerAIn8n NodeLangChainAICrewAIAILlamaIndexAISupabaseChrome ExtensionSoon
    PlaygroundPricingStatus

    5,000 free requests · No credit card

    Reference

    API Changelog

    A running log of changes to the AlterLab API. New endpoints, breaking changes, improvements, and fixes.

    Versioning Policy

    AlterLab uses URL path versioning (/api/v1/). Breaking changes get a 90-day deprecation window. See the API Versioning Policy for details.

    Latest Changes

    v5.0.8Secure Retries and Reliable Proxies
    September 4, 2026
    Improved

    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...

    Improved

    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...

    Improved

    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 ...

    Fixed

    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...

    Fixed

    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...

    Fixed

    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...

    Fixed

    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.

    Fixed

    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...

    Fixed

    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.

    Security

    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.

    Security

    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...

    Improved

    General bug fixes and improvements

    Plus 10 internal improvements for better reliability and performance.

    v5.0.7Smarter Routing and Proxy Safety
    September 2, 2026
    Improved

    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...

    Improved

    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.

    Improved

    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.

    Fixed

    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.

    Fixed

    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...

    Fixed

    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.

    Fixed

    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 ...

    Security

    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.

    Improved

    General bug fixes and improvements

    Plus 4 internal improvements for better reliability and performance.

    v5.0.6Enhanced Scraping and Streaming Reliability
    September 1, 2026
    Fixed

    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.

    Fixed

    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.

    Improved

    General bug fixes and improvements

    This release includes 1 internal improvements for better reliability and performance.

    v5.0.5Workspace Security and Unified Billing
    August 30, 2026
    New

    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...

    Improved

    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...

    Improved

    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...

    Security

    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...

    Security

    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...

    Fixed

    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...

    Fixed

    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...

    Fixed

    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...

    Fixed

    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...

    Fixed

    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.

    Fixed

    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...

    Fixed

    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...

    Fixed

    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 ...

    Improved

    General improvements

    This release includes general improvements and maintenance updates.

    v5.0.4Smarter Scrapes and Precise Billing
    August 27, 2026
    New

    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.

    Improved

    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.

    Improved

    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.

    Improved

    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.

    Fixed

    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.

    Fixed

    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.

    Fixed

    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.

    Fixed

    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.

    Fixed

    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.

    Improved

    General bug fixes and improvements

    Plus 4 internal improvements for better reliability and performance.

    Fixed

    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...

    Fixed

    deployment recovery CI contracts

    - mark the new command-target deployment tests executable.

    Improved

    Fail closed production deployment recovery

    - normalize container dotenv through a non-evaluating renderer before production shell consumers load it.

    Improved

    Decode quoted production dotenv escapes

    Decode valid quoted dotenv escapes exposed by production.

    Improved

    General improvements

    This release includes general improvements and maintenance updates.

    v5.0.3Improved Scraping Reliability and Session Handling
    August 12, 2026
    Fixed

    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.

    Improved

    General bug fixes and improvements

    Plus 1 internal improvement for better reliability and performance.

    Security

    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.

    Improved

    General improvements

    This release includes general improvements and maintenance updates.

    Fixed

    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

    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.

    Security

    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.

    v5.0.2Reliable Scheduled Crawls and Billing
    August 11, 2026
    Improved

    General bug fixes and improvements

    This release includes 2 internal improvements for better reliability and performance.

    Improved

    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.

    Improved

    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.

    Fixed

    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.

    Fixed

    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.

    v5.0.1Reliable Batching and Cost Controls
    August 10, 2026
    Improved

    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.

    Improved

    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.

    Improved

    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...

    Fixed

    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...

    Fixed

    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...

    Fixed

    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...

    Fixed

    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.

    Security

    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.

    Improved

    General bug fixes and improvements

    Plus 9 internal improvements for better reliability and performance.

    v5.0.0Smarter Search Routing and Redesigned Auth
    August 9, 2026
    New

    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.

    New

    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.

    New

    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.

    New

    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.

    New

    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.

    Improved

    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.

    Improved

    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.

    Improved

    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.

    Improved

    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.

    Fixed

    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.

    Fixed

    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.

    Security

    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.

    Security

    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.

    Security

    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.

    Improved

    General bug fixes and improvements

    Plus 27 internal improvements for better reliability and performance.

    v4.1.3Enhanced SDK Capabilities and API Reliability
    August 2, 2026
    Improved

    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.

    Improved

    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.

    Improved

    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.

    Improved

    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...

    Fixed

    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.

    Fixed

    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...

    Improved

    General bug fixes and improvements

    Plus 43 internal improvements for better reliability and performance.

    Improved

    General improvements

    This release includes general improvements and maintenance updates.

    How to Stay Updated

    1

    Check this page for a summary of all API changes with each release.

    2

    Visit the full changelog for a detailed, filterable timeline of all product updates including frontend and infrastructure changes.

    3

    Watch for deprecation headers in API responses. Deprecated endpoints return a Sunset header with the removal date.

    Change Types

    TypeDescriptionAction Required?
    NewNew endpoints, parameters, response fields, or SDK methodsNo
    ImprovedPerformance improvements, better error messages, enhanced behaviorNo
    FixedBug fixes, corrected behavior, resolved edge casesNo
    SecuritySecurity patches and vulnerability fixesReview recommended
    BreakingRemoved 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→
    ← Error CodesVersioning Policy →
    Last updated: June 2026

    On this page