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

    v4.1.1Enhanced Scraping Reliability and Accurate Billing
    July 27, 2026
    New

    Data retention policy

    We have published a clear, formalized data retention and recovery policy for past scraping jobs. This helps development teams accurately plan their local data synchronization intervals and log storage...

    Improved

    Smoother maintenance updates

    Upgraded background task cleanup logic to prevent premature task cancellation during platform updates. Active jobs and cleanup operations now gracefully persist or complete without interruption.

    Improved

    Robust credit retry logic

    Upgraded safeguards in our credit refund retry pipeline automatically isolate processing failures. This ensures credit transactions are never lost or unaccounted for under any network conditions.

    Fixed

    Precise credit refunds

    Fixed a refund loop that triggered duplicate refunds when accounts had insufficient balances. This ensures completely accurate credit accounting for all structured scraping requests.

    Fixed

    Accurate credit balances

    Fixed a balance discrepancy for accounts with negative credit balances during refunds or credit grants. Real-time balance caches now perfectly align with your ledger history to ensure accuracy.

    Security

    API uptime safeguards

    Added per-IP rate limiting to the API readiness endpoint to protect platform availability from accidental high-frequency polling. This ensures health checks remain responsive under heavy load.

    Improved

    General bug fixes and improvements

    Plus 47 internal improvements for better reliability and performance.

    v4.1.0Sub-100ms Scraping Speed and Billing Precision
    July 25, 2026
    Improved

    Accelerated Structured Extraction

    We moved structured data conversion off the API response path and directly cached the outputs. This eliminates redundant processing and cuts response latency by up to 8 seconds for cached structured r...

    Improved

    Sub-100ms Scraping Latency

    We optimized proxy allocation rules to eliminate a 1-second latency floor for basic scraping tasks. Requests that do not require custom proxies are now completed in just 40 to 109 milliseconds.

    Improved

    Synchronous Scraping Scale-up

    Our connection multiplexing for synchronous scrapes has been fully redesigned. This significantly reduces connection bottlenecks and improves query response times during heavy parallel scraping worklo...

    Improved

    Fast-Path Structured Extraction

    Lightweight extraction tasks under 50 KiB are now processed directly within the scraping stage, eliminating unnecessary staging hops. This reduces delivery overhead and ensures faster turnaround for s...

    Improved

    Instant Credential Validation

    API credential validation is now optimized to run directly from high-speed cache memory without hitting primary databases on subsequent requests. This lowers authentication latency while maintaining r...

    Improved

    Localized Geotargeted Headers

    Scraped assets and headers are now automatically built using the correct country context matching your assigned proxy. This ensures highly localized and accurate web scraping results across all target...

    Fixed

    Instant Spend Limit Releases

    Active spending reservations are now instantly released when an API request fails validation checks. This guarantees that failed or rejected requests never artificially count against your spending or ...

    Fixed

    Preflight Webhook Safety

    Webhook URL validation is now completed before any charges or debits are applied to your account. This ensures invalid destination URLs are rejected immediately with no temporary billing impact.

    Fixed

    Automatic Disruption Protection

    Active scraping jobs are now automatically and safely requeued if a processing node undergoes scheduled maintenance or shutdown. Your jobs are guaranteed to finish executing seamlessly without being d...

    Fixed

    Better Ticket Attachment Flows

    Support ticket submissions and replies now validate attachments before sending, preventing silent file failures. You will receive real-time warnings, accessible error feedback, and retry controls for ...

    Fixed

    Accurate Search Fallback Deadlines

    Optimized search engine fallback latency by enforcing a strict 25-second deadline for parallel dispatch, fallback, and parsing. This ensures your search API calls reliably return responses within the ...

    Fixed

    General Improvements and Fixes

    This release also includes several general reliability enhancements. These include automatic background retries for failed search refunds, accessibility labeling improvements for support screens, and ...

    Security

    Improved Attachment Security

    Enforced strict, normalized ownership scopes on support ticket attachments. Unauthorized attempts to query or access ticket media now return a generic 404 error, fully protecting your uploaded support...

    v4.0.1Accelerated Scrapes and Precise Billing
    July 21, 2026
    Improved

    Instant structured job handoffs

    Structured scraping requests now complete up to one second faster. By replacing polling intervals with instant queue handoffs, your extracted data is delivered immediately after the page is scraped.

    Improved

    Bypassed structuring for raw scrapes

    Scrape requests that only require raw HTML responses now completely bypass the structuring queue. This optimization removes unnecessary processing to deliver your raw content significantly faster.

    Improved

    Reduced peak latency tail

    We capped individual retry timeouts for advanced browser-based requests. This eliminates the long latency tail, ensuring slow requests either failover rapidly or resolve within a predictable time limi...

    Improved

    Resilient schema extraction engine

    Our automatic data extraction engine now automatically self-heals when encountering offline AI model providers. This protects your parsing pipelines from external service disruptions.

    Fixed

    Billing protection for blocked pages

    You will not be billed for scrapes that encounter block pages, challenges, or system errors. Our detection systems now identify these occurrences to ensure false successes are refunded immediately.

    Fixed

    Preserved upstream status codes

    Structured scrape responses now return the actual HTTP status code from the targeted upstream website rather than defaulting to 200. This enables more precise error handling in your application.

    Fixed

    Accurate scrape outcome tracking

    Scrapes that return successful responses from non-200 pages, like soft-404s, are no longer falsely marked as failed in your usage analytics. This ensures your dashboard metrics are accurate.

    Improved

    General bug fixes and improvements

    Plus 15 internal improvements for better reliability and performance.

    v4.0.0Unmatched Speed and Automated IP Recovery
    July 20, 2026
    New

    Faster passive verification

    The scraping engine now automatically identifies domains that only require background verification checks and skips unnecessary behavioral wait times. This cuts request latency on these sites by up to...

    New

    Automatic IP block recovery

    The platform now automatically detects connection-level proxy blocks and triggers a fresh egress route rotation. Instead of failing immediately when an IP is flagged, your requests are seamlessly retr...

    New

    Enterprise detection compatibility

    We have added automatic detection and optimized routing pathways for multiple advanced, enterprise-grade bot protection systems. This ensures significantly higher success rates when scraping highly se...

    New

    Direct deep-links for support ratings

    Support ticket resolution emails now include direct deep-links that automatically highlight and focus the satisfaction rating widget on our platform. This lets you leave feedback on your support exper...

    Improved

    Parallel multi-engine requests

    Optimized request routing to initiate parallel connection strategies from the very start of a request. This removes sequential delays on standard request paths, leading to significantly faster overall...

    Improved

    Budget-aware request timeouts

    Request connection timeouts are now dynamically adapted to match your remaining request time budget rather than using a static default. This ensures requests either complete successfully or fail-fast ...

    Improved

    Sticky session documentation updates

    Updated our developer documentation and AI-agent reference files to include details on the 10-minute automatic exit IP rotation cycle. This provides clearer guidance on maintaining long-lived scraping...

    Improved

    Improved session persistence reliability

    Fixed a routing key mapping issue during back-end migrations to ensure persistent scraping sessions remain uninterrupted. Your sticky sessions and designated identities will transition seamlessly with...

    Fixed

    Enhanced verification polling stability

    Replaced periodic polling checks with event-driven triggers when waiting for verification challenges to resolve. This eliminates unnecessary delays and ensures requests proceed the millisecond a verif...

    Fixed

    Prevented early challenge timeouts

    Fixed a race condition where a pre-existing stale-content timeout could trigger a fraction of a second before the newer rejection grace period expired. This prevents premature failures on slow-loading...

    Fixed

    Accurate billing for failed pages

    Corrected a routing and billing issue on Adidas homepage URLs where queries with empty parameters returned a bad request error disguised as a successful HTTP 200. These requests are now properly handl...

    Fixed

    Seamless interactive challenge recovery

    Fixed an issue where transient background verification failures would permanently cancel subsequent verification attempts. The system now robustly continues the full verification flow even if initial ...

    Fixed

    Targeted content wait on retry

    Solved an issue where retried requests that successfully bypassed verification pages would prematurely skip waiting for target selectors. The engine now correctly waits for your specified elements to ...

    Fixed

    Keyboard focus collision fix

    Resolved a UI focus issue where simultaneously mounted mobile and desktop versions of the customer support feedback widget would compete for keyboard focus. This improves accessibility and usability o...

    Improved

    General bug fixes and improvements

    Plus 34 internal improvements for better reliability and performance.

    New

    New anti-bot benchmarks

    You can now view live difficulty scores across all our comparison pages. This helps you compare real-world performance against modern detection systems to make informed integration decisions.

    Improved

    Optimized request latency

    We streamlined our pre-scrape routing pipeline to eliminate redundant checks. This reduces initial routing latency by over two seconds for standard requests, allowing your scraping tasks to start much...

    Improved

    Consistent large-scale exports

    We added automatic lock renewals during large-scale data export cycles. This prevents tasks from expiring mid-cycle, eliminating duplicate files and ensuring consistent data delivery.

    Improved

    Accessible comparison metrics

    We added full ARIA progressbar semantics to the difficulty scorebars on our comparison pages. This ensures screen readers and assistive devices can easily interpret our real-world benchmark data.

    Fixed

    Challenged request recovery

    We enabled advanced request properties when encountering temporary verification screens. This automatically rotates IPs with full browser characteristics, boosting success rates on guarded domains.

    Fixed

    Batch poller reliability

    We resolved an issue where batch workers performed redundant retries after losing their execution locks. This prevents duplicate tasks and ensures much more stable long-running operations.

    Fixed

    Resilient batch exports

    We added error isolation to the export backfill process. A transient error with a single record will no longer abort the entire run, ensuring your successful scraped data is safely delivered.

    v3.18.3Dynamic Geo-Coherence and Reliable IP Routing
    July 19, 2026
    New

    Guaranteed Clean Proxy IPs

    Dedicated proxy sessions now benefit from automated clean-IP pre-screening. The system automatically rerolls blacklisted addresses before your request is sent.

    New

    Self-Service Billing Management

    You can now manage and cancel subscriptions directly within your customer billing portal. This ensures a smoother and more self-sufficient experience.

    Improved

    Dynamic Timezone Alignment

    Browser sessions now dynamically match the timezone and locale of the proxy exit IP. This ensures a cohesive geo-profile that bypasses strict security checks.

    Improved

    Default Provider Diversity

    We enabled IP and provider diversity checks across all scraping requests by default. This automatically routes traffic to avoid localized range blockages.

    Improved

    Multi-System Detection

    Our platform now detects when websites use multiple overlapping security systems. The API dynamically applies the best routing strategy for each layer.

    Improved

    Modernized Browser Signatures

    Automated session tools now utilize fully modernized browser signatures. These profiles correctly align User-Agents with matching client hints.

    Fixed

    Staggered Parallel Requests

    Resolved an issue where concurrent requests using identical fingerprints were fired instantly. A micro-stagger now prevents target sites from flagging traffic.

    Fixed

    Coordinated IP Validation

    Fixed a bug where different internal checks could evaluate different IPs. The system now strictly threads the same resolved address across all security checks.

    Fixed

    Secure Session Isolation

    Resolved an issue where concurrent proxy requests could share or overwrite settings. Sticky sessions are now completely isolated across target domains.

    Fixed

    Billing Duplication Prevention

    Added idempotency protection when generating billing configurations. This prevents duplicate sessions from being created during concurrent client clicks.

    Fixed

    Challenge-Cookie Cache Stability

    Cookies for target domains with special characters are now correctly cached. This avoids unexpected re-verification loops on secure websites.

    Fixed

    Detailed Timeout Metrics

    Request timeouts now record specific failure reasons in your usage tracking metadata. This simplifies troubleshooting for slow target websites.

    Fixed

    General Dashboard Improvements

    This release also resolves several minor issues. We fixed server errors on support pages, preview flash glitches, and background resource cleanup.

    Improved

    General bug fixes and improvements

    Plus 19 internal improvements for better reliability and performance.

    v3.18.2Flexible Billing and Enhanced Session Privacy
    July 18, 2026
    New

    Stateful scraping sessions

    You can now maintain a consistent residential IP and share cookies across sequential requests using a session handle. This simplifies multi-step tasks like logging in and then scraping data.

    Improved

    Universal session IP pinning

    Stateful session IP pinning is now supported across all scraping tiers, including direct HTTP requests. Sequential calls to simple and complex pages alike will now share the exact same residential IP.

    Improved

    Accurate credit pre-billing

    Credit pre-estimations for browser-tier tasks are now calculated accurately at submission. This prevents temporary over-billing and ensures your playground balance matches the final processed tier pri...

    Improved

    SDK-side session validation

    The Node SDK now includes client-side validation for stateful session handles and lifetimes to match the Python SDK. This provides immediate feedback on invalid inputs before sending requests to the A...

    Fixed

    Stateful session race fix

    Resolved a concurrency race condition in stateful sessions that could cause captured cookies to be dropped when scraping in parallel. Your shared cookie jar remains accurate during concurrent actions.

    Fixed

    Browser cookie capture

    Captured browser cookies are now correctly recorded and available in your stateful sessions. This enables seamless, stateful transitions between standard HTTP scraping and browser-driven actions.

    Fixed

    Validation for JS features

    Requesting browser-only features without enabling JavaScript rendering now returns a clear validation error. This prevents silent execution failures on incompatible non-JS tiers.

    Fixed

    Stateful routing leak fix

    Fixed a routing leak in fast-fetch discovery calls during stateful sessions to guarantee that all traffic stays pinned. All sub-requests now strictly maintain your designated residential exit IP.

    Fixed

    Lost session detection

    Stateful sessions now return a clear indicator when a session has expired or dropped rather than failing silently. This allows you to easily detect lost states and re-initialize sessions.

    Fixed

    Complex HTML parsing

    Fixed a parsing crash when converting complex, deeply nested HTML structures into clean markdown or JSON. This prevents unexpected validation errors when scraping highly structured pages.

    Fixed

    Dashboard playground stability

    Fixed a dashboard issue where balance refresh errors could cause unhandled promise rejections. This stabilizes the developer playground interface during balance updates.

    Security

    Domain-scoped session cookies

    Stateful session cookies are now securely scoped to their specific domains. Reusing a single session handle across different host domains will no longer leak or replay cookies between them.

    Security

    Session payload sanitization

    Captured session cookies are now sanitized to strip control characters and limit payload sizes. This protects stateful operations and prevents unexpected errors during session replay.

    Improved

    General bug fixes and improvements

    Plus 22 internal improvements for better reliability and performance.

    New

    Self-Serve Billing Details

    You can now update your company billing address and tax ID directly from the self-serve billing portal. This ensures that automatically generated invoices reflect the correct corporate details without...

    Improved

    Compact Billing Layout

    The billing dashboard layout has been optimized to reduce empty vertical space and group active details more compactly. Active payment methods, recharges, and receipt tables are now positioned for eas...

    Security

    Strict Session Isolation

    Cross-origin cookies from third-party iframes are now strictly filtered and isolated from your session's cookie jar. This prevents unauthorized third-party cookies from being replayed to your primary ...

    Security

    Fail-Safe Cookie Scoping

    If a target URL fails to parse during request scoping, the connection now fails closed by default rather than exposing unfiltered cookies. This ensures zero risk of cross-origin leakage during complex...

    Security

    Control Character Protection

    Our request screening now rejects non-standard C1 control characters and Unicode line separators in session inputs. This defense-in-depth update blocks sophisticated injection techniques that exploit ...

    Security

    Secure Cookie Sanitization

    Response cookies and active session updates are now subjected to rigorous sanitization before ingestion. This closes sanitization gaps and prevents malformed cookies from destabilizing your session ja...

    Security

    Enhanced Token Redaction

    To protect sensitive active data, session-specific proxy tokens are now completely redacted from all system logs. This guarantees your active credentials remain private during execution.

    Fixed

    Session Cookie Protection

    We resolved a session-saving bug where fully invalid or malicious cookie harvests could accidentally overwrite and erase your existing valid cookie jars. Your active, functional session credentials wi...

    Fixed

    Mislabeled Session Metadata

    We corrected a response metadata issue where request logs mislabeled session status as active for standard sticky sessions. Your API response logs now accurately reflect the exact proxy configuration ...

    v3.18.1Streamlined Billing and Reliable Extraction
    July 17, 2026
    New

    Iframe content escalation

    Automatically detects and extracts content from pages whose primary text is nested inside same-origin iframes. This ensures that media-heavy or app-like pages are captured completely.

    Improved

    Reliable Google search scraping

    Enhanced Google search result and ad-capture reliability to prevent silent fallbacks and missing data. Your search scraping queries are now more consistent and complete.

    Improved

    Refunds for empty text

    Scrapes returning empty main text content are now automatically refunded. This ensures you only pay for successful extractions on pages with readable text.

    Improved

    Amazon seller offer scraping

    Improved session and cookie continuity when retrieving supplementary product and seller offer details. This prevents authorization issues and improves data completeness.

    Improved

    Deterministic image selection

    The image selection algorithm now uses deterministic tiebreakers to ensure reproducible and consistent results. You will now get identical image rankings across repeated scrapes.

    Improved

    Early AWS Role ARN validation

    Malformed AWS Role ARNs for custom S3 delivery are now validated and caught early at write time. This prevents downstream delivery failures and silent errors on execution.

    Improved

    Faster custom S3 delivery

    Credentials validation for cross-account S3 deliveries has been optimized to run completely non-blocking. This prevents queue stalls and maximizes overall throughput.

    Fixed

    Page scroll timeout fix

    Prevents 300-second timeouts on extremely long or iframe-heavy pages when JavaScript rendering is enabled. This ensures complex sites finish loading within normal limits.

    Fixed

    Advertiser identity resolution

    Resolved issues with advertiser transparency details to consistently return accurate names, verification statuses, and locations. This improves data reliability for marketing research.

    Fixed

    Accurate billing history

    Fixed dashboard and receipt history rendering so that paired account recharges are no longer hidden. This ensures your billing statements and balances match up perfectly.

    Improved

    General bug fixes and improvements

    Plus 23 internal improvements for better reliability and performance.

    New

    Billing identity setup

    You can now manage your legal billing identity directly from your organization dashboard. This information automatically synchronizes with our billing systems.

    Improved

    Collect billing details at checkout

    Our checkout system now prompts for and collects your billing address and tax/VAT info during purchase. This ensures auto-generated invoices are fully compliant.

    Improved

    Self-serve customer portal

    Self-serve users can now directly access the payment portal to manage their payment methods. The portal link is now fully accessible on the billing dashboard.

    Improved

    Redesigned billing layout

    We have redesigned the billing page layout to support accounts with a high volume of transactions. The dashboard now features a clean and perfectly aligned layout.

    Improved

    Instant billing page loading

    The billing dashboard now loads instantly by leveraging cached document URLs rather than requesting live links on every render. This eliminates page hangs.

    Fixed

    Automatic failed extraction refunds

    If a request successfully retrieves a page but the subsequent data-extraction stage fails, your account is now automatically refunded. This prevents lost credits.

    Fixed

    Deeply nested page extraction

    We resolved an issue where structured data extraction from deeply nested HTML pages would occasionally crash. The extraction engine now handles complex layouts reliably.

    Fixed

    Accurate regional block billing

    Requests that return regional or geographical restriction block pages are now correctly recognized as failures. These requests will no longer be counted as successful.

    Fixed

    Clearing optional billing fields

    We fixed an issue where attempting to clear an optional billing field was ignored by the backend. You can now freely clear and update all organization billing fields.

    Fixed

    Organization switching stability

    We added a loading guard to prevent slow connections from displaying incorrect billing data when switching accounts. Billing fields now reset cleanly and synchronously.

    Security

    Sanitized billing API errors

    Upstream error details from our payment processors are now thoroughly sanitized before being returned. This prevents internal processor details from being exposed.

    Security

    Safe billing receipt redirects

    We added strict hostname validation to the billing receipt download proxy to prevent open-redirect vulnerabilities. This ensures you are only redirected to authorized domains.

    Security

    Complete account reclamation cleanup

    Reclaiming an account now completely deletes any associated billing profiles and payment details from the provider. This ensures unauthorized profiles do not survive recovery.

    v3.18.0Faster Scraping and Programmatic Triage
    July 16, 2026
    New

    Resolve tickets programmatically

    You can now resolve or reopen support tickets directly using your API keys, removing the need for user JWTs. This simplifies the process of automating ticket lifecycles within your own systems.

    New

    Automate ticket triage classifications

    You can now programmatically update ticket priorities and tags using API key authentication. This lets you integrate automated ticket classification systems directly into your workflow.

    New

    Merge duplicate support tickets

    We have introduced a new API endpoint to merge duplicate support tickets programmatically by reference. This allows your team to automate the cleanup of redundant incoming customer requests.

    Improved

    Millisecond-level rate limit queueing

    Deferred requests now resume with millisecond-level precision instead of waiting a flat 5-second ceiling. This significantly increases your overall scraping throughput.

    Improved

    Concurrent proxy IP distribution

    Proxy routing now distributes concurrent requests across a wider pool of exit IPs. This prevents traffic concentration on single IPs and dramatically reduces rate-limiting blocks.

    Improved

    Predictive scraper tier escalation

    The platform now prevents unnecessary escalation to expensive browser-based scraping tiers during transient network or proxy degradations. This keeps your API usage highly cost-effective.

    Improved

    Humanized request pacing delay

    Scraping requests now incorporate natural inter-request delays and paced retries on failure. This human-like behavior reduces detection rates on websites with strict bot protection.

    Improved

    AI agent documentation endpoints

    We have introduced new agent-friendly documentation routes. This allows developers' AI assistants to easily parse and query our API schemas for seamless integration.

    Improved

    Enforced rotating proxy blacklists

    IP blacklists are now strictly enforced in rotating proxy mode. The system automatically re-rolls to a clean connection if a known bad or burned exit IP is detected during a request.

    Improved

    Automatic JSON response parsing

    When targeting JSON API endpoints, the parsed response body is now cleanly exposed in the content JSON field. This makes extracting structured data much more straightforward.

    Fixed

    Shielded active scraping sessions

    Active scraping sessions are now protected from premature background cleanup tasks. This eliminates unexpected session terminations and ensures long-running requests finish successfully.

    Fixed

    Empty HTML content validation

    Requests returning empty HTML shells with no visible content are now correctly identified and escalated. This ensures you always receive complete and valid page data.

    Fixed

    Auto-recharge invoice download fix

    We resolved a dashboard bug where auto-recharge transactions were displayed as non-clickable items. You can now easily view and download invoice receipts for all transactions.

    Fixed

    Clean ticket reply threads

    Submitting whitespace-only notes will no longer generate empty, confusing ticket responses in the system. This keeps your support communication clean and readable.

    Improved

    General bug fixes and improvements

    Plus 47 internal improvements for better reliability and performance.

    Improved

    Hidden Amazon Price Retrieval

    Automatically extract prices for products under Amazon's Minimum Advertised Price restrictions. The API now retrieves hidden prices instead of returning empty fields.

    Improved

    Cost-Optimized Low-Volume Scraping

    Low-volume domains now transition to cheaper scraping tiers much faster once success is proven. This prevents requests from getting stuck on expensive browser-rendering tiers, saving you credits.

    Improved

    Faster Browser Escalation Retries

    Requests requiring automatic browser escalation now retry on an optimized schedule instead of sharing standard delays. This significantly reduces overall latency and ensures jobs complete faster.

    Improved

    More Responsive Request Dispatching

    Eliminated unexpected latency spikes when starting requests after the scraper has been idle. Queue poll delays are now strictly bounded, resulting in faster and more consistent response times.

    Fixed

    Robust S3 Credential Validation

    We added validation to S3 delivery configurations during creation and credential rotation. This prevents configuration errors, such as missing external IDs, before they cause delivery failures.

    Fixed

    Improved Handling of Short Responses

    Restored reliable escalation to browser rendering for pages that return extremely short, non-JSON initial responses. This ensures that minimal landing pages are properly rendered and resolved.

    Fixed

    Reliable LLM Configuration Setup

    Resolved an initialization issue that could prevent the automatic configuration of LLM-based extraction models. Your AI-assisted parsing tasks will now configure and run reliably on startup.

    v3.17.1Enhanced Scraping Reliability and Security
    July 15, 2026
    Improved

    Enhanced Scrape Job Reliability

    We upgraded our job delivery system to automatically recover tasks affected by unexpected transient errors. This ensures your scraping requests are completed reliably without getting stuck.

    Security

    Custom Proxy Metadata Isolation

    We resolved a high-concurrency race condition to ensure strict data isolation for custom proxy configurations. Your proxy integration details are now fully secure during concurrent scraping jobs.

    Improved

    General bug fixes and improvements

    Plus 10 internal improvements for better reliability and performance.

    v3.17.0Secure Sign-Ins and Enhanced API Reliability
    July 14, 2026
    Improved

    Responsive domain self-healing

    Our automatic recovery now uses recent success rates instead of lifetime averages. This allows the platform to instantly adapt and bypass detection on domains experiencing sudden degradation.

    Improved

    Strict quality checks for successful scrapes

    A new 15KB minimum content threshold applies across all scraping paths. This ensures empty pages or small anti-bot screens are marked as failures and never billed as successful scrapes.

    Improved

    Context manager support in Python SDK

    We added context manager support and explicit close methods to the Python SDK. This properly cleans up client sessions and active event loops, preventing persistent background memory leaks.

    Improved

    Optimized HTML-to-Markdown parsing

    An optimized single-pass parser now handles unclosed elements in HTML documents. This eliminates processing lag and speeds up markdown extraction for complex, structured pages.

    Improved

    Smarter connection failure routing

    The platform now detects IP-level connection rejections to instantly block wasteful escalation. This ensures faster failover, reduced latency, and overall smarter request routing.

    Fixed

    Reliable automatic billing and deposits

    Fixed an issue where billing webhooks failed during automatic recharges or deposits. This ensures billing transactions and credit top-ups process instantly without account disruption.

    Fixed

    Accurate success metrics in digest emails

    Fixed a bug where digest, billing, and credit emails reported a zero percent success rate. Email metrics are now fully accurate and reflect the true success outcomes of your jobs.

    Fixed

    Proper Set-Cookie handling in Node SDK

    Fixed an issue in the Node SDK's fetch wrapper where multiple Set-Cookie headers were folded into a single comma line. They are now properly preserved for seamless session tracking.

    Fixed

    Unicode support in agent metadata

    Fixed a crash that occurred when metadata headers contained emojis, accented characters, or non-Latin scripts. The SDKs now safely URL-encode all agent configuration fields.

    Fixed

    Intact URLs in extracted markdown links

    Resolved a bug where legal URL characters were over-escaped in markdown generation. Extracted links and references now render perfectly and redirect to the correct target URLs.

    Fixed

    Robust concurrent update validation

    Enhanced safety for concurrent data updates by validating database records immediately before committing. This prevents rare race conditions and data overwrites under high load.

    Fixed

    Eliminated race condition on trial keys

    Fixed an intermittent race condition that caused valid trial key requests to be incorrectly rejected with unauthorized errors, ensuring smoother testing and onboarding.

    Fixed

    General bug fixes and improvements

    Includes several developer-experience and minor platform improvements. These include Node SDK documentation updates, optimized database locks, and proper ID-independent route caching.

    Security

    Sanitized API telemetry logging

    Improved data privacy by scrubbing raw exception details from telemetry logs. This prevents accidental exposure of sensitive internal runtime information in reports.

    Security

    Hardened API gateway rate limiting

    Resolved gateway vulnerabilities where crafted paths could bypass standard rate limits. All administrative and download endpoints are now strictly isolated and throttled.

    New

    Secure Account Reclaiming

    Users can now seamlessly reclaim their email addresses during sign-in if their email was previously registered via unauthenticated signup. This process automatically revokes unauthorized credentials a...

    Improved

    Resilient AI Extraction Model Routing

    AI-powered scraping tasks are now more resilient to third-party model deprecations. The system automatically redirects queries to active fallback pools, preventing unexpected 404 errors during extract...

    Improved

    Node SDK Subpath Exports

    The Node SDK now supports subpath imports for helper modules. Developers can import utility modules like cookie encryption directly using standard paths without encountering module resolution errors.

    Improved

    Standardized Node SDK Imports

    We standardized our SDK references to use the official npm package name, alterlab. Documentation, templates, and public examples have been updated to ensure smooth integration without using outdated p...

    Improved

    Updated Affiliate Commission Cap

    We updated our affiliate commission payouts to align with our standard rewards policy. Affiliates now receive a 20% commission on their referred user's first deposit, capped at a maximum of $10.

    Improved

    Improved DNS Resolution Stability

    We optimized DNS caching and watchdog intervals across our web scraping worker fleet. This resolves transient resolution failures under heavy scraping volumes, making concurrent network requests much ...

    Fixed

    Reliable JS-Rendering Escalation

    We fixed a rendering conflict where forcing JavaScript execution could trigger redundant browser behaviors. Scraping requests now scale cleanly and consistently when JavaScript rendering is requested.

    Fixed

    Dashboard B2B Profile Reliability

    Fixed routing issues on the web dashboard that caused B2B demographic profiles, verifications, and stats to intermittently fail. These dashboard features are now fully functional and stable in product...

    Fixed

    Robust Team Invitation Handling

    Resolved an issue where sending duplicate organization invites or triggering database conflicts would return a 500 server error. The API now correctly returns a 409 Conflict status and handles retries...

    Fixed

    Asynchronous Queue Stability

    Fixed a task lifecycle leak where background processes in our message queue consumers could be prematurely destroyed under high load. This ensures reliable and smooth handling of asynchronous scraping...

    Security

    Enhanced API Key Bruteforce Protection

    Introduced a dedicated per-IP soft-blocking guard to defend against API key brute-force attacks. The system tracks cumulative authentication failures and enforces ceilings, preventing attackers from e...

    Security

    Trial Key Spend Limit Isolation

    Enforced strict validation checks on spend-limit API endpoints for our trial key pool. This ensures trial users cannot read, modify, or delete spend-limit configurations belonging to other trial accou...

    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