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

    v4.1.2Performance Improvements
    July 28, 2026
    Improved

    feat(infra): surface the ASN-remediation threshold gap in antibot census

    investigation: the platform's ASN-remediation machinery.

    Improved

    feat(worker): aggregate per-vendor per-tier success-rate telemetry

    Adds to : a read-only aggregation over (the live per-attempt vendor classification) answering "for vendor V, what's the success rate at tier N?" — the capability 's audit found missing.

    Improved

    fix(infra): close restore-database.sh host-TCP guard bypass

    Closes the third addressing axis of 's production-target confirmation guard: /, used whenever doesn't resolve to a running local container (the host-TCP fallback path).

    Improved

    feat(content): restore 2 of ~11 blog posts as new forward content

    Four blog-content migrations (, ) never ran on production and cannot be replayed — they hardcode an author user and blog category that don't exist on production, and executing them would FK-fail m.

    Improved

    fix(worker): real end-to-end antibot_hint fallback tests, fix kasada/shape telemetry monitoring syst

    Batch fix for three review findings from /, all in and its tests.

    Improved

    fix(worker): don't blind-escalate tier on unclassified 429/5xx job retry

    's job-level retry gate bumped a retried job's to 2 (proxy tier) for any non-terminal failure — including (429), (5xx), and a bare unclassified status (e.g.

    Improved

    fix(infra): harden decrypt-secrets.sh sibling config writes against symlink planting

    The filed finding claimed at would write decrypted secrets through a pre-existing symlink at.

    Improved

    fix(billing): reject auto-recharge threshold a single recharge cannot clear

    Batch fix for two review findings in / , on the same constant , batched per the parent issue's stated exception to the billing never-batch rule.

    Improved

    fix(api): announcement CTA model residue — userinfo threat model + PublicCTA length parity

    Batch fix for two LOW/POSSIBLE review findings from , both on the announcement CTA models ( / ).

    Improved

    fix(worker): route cold-start antibot_hint fallback through shared vendor_engine

    Batch (three members).

    Improved

    fix(api): resolve announcement CTA href residue from

    Resolves the three review findings from (which fixed , the backend protocol-relative/backslash bypass).

    Improved

    fix(batch): unvalidated input and missing startup validation — 3 fail-loud-before-use gaps

    Three fail-loud-before-use validation gaps, batched by concern per .

    Improved

    fix(ci): reclaim runner disk space and log df -h in backup-restore-drill

    Fixes : the backup restore drill (run 30323945135) failed with — an ENOSPC on the CI runner mid-restore, **not** a corrupt backup.

    Improved

    fix(batch): comment and doc accuracy — four claims that no longer match the code

    Four batched review findings where a comment, docstring, or message asserts something the code does not do.

    Improved

    fix(worker): per-domain concurrency gate is a third, unaccounted-for min_tier consumer

    's PER-DOMAIN CONCURRENCY GATE was a third, unaccounted-for consumer (review finding on ): it read directly, bypassing the Python-registry precedence that and the API admission gate both hono.

    Improved

    General bug fixes and improvements

    Plus 35 internal improvements for better reliability and performance.

    Improved

    fix(infra): stop deleting the local source backup after a verified off-site upload

    deleted the local source after a verified upload.

    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.

    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