Expanded Limits, Across all tiers - Our Gift to you! Learn more →

AlterLab
SearchResearchPricingComparePlaygroundBlogDocsChangelog
    AlterLabAlterLab
    PricingComparePlaygroundBlogDocsChangelog
    IntroductionQuickstartInstallationYour First Request
    REST APICrawl APIMap APISearch APIResearch APINewSERP APINewExtract APIAIJob PollingDomain StatsNewGeocode APINewNews APIBatch ResultsNewAPI KeysSessions APINewEnterprise APIEnterprise
    AccountAutoAI VisibilityAutoAlertsAutoAuthAutoBillingAutoCrawlAutoExtractAutoIntegrationsAutoKeysAutoMapAutoMonitorsAutoOrganizationsAutoResearch SchedulesAutoRunsAutoSchedulesAutoScrapeAutoSearchAutoSearch SchedulesAutoSessionsAutoUser WebhooksAutoV1 EndpointsAutoAffiliatesAutoAgentAutoAgent OnboardingAutoAgent VisibilityAutoAnalyticsAutoApprovalsAutoArtifactsAutoAttributionAutoB2BAutoBatchAutoBeta FeaturesAutoBlogAutoBuyerAutoChatAutoConnectionsAutoConnectorsAutoContact ListsAutoCreatorAutoCross SellAutoDashboardAutoDefaultsAutoDomainsAutoEmail PreferencesAutoFcAutoHandsAutoHealthAutoJobsAutoListingsAutoMaintenanceAutoNewsAutoOauthAutoOauth GrantsAutoPage InspectAutoPlatformAutoPresetsAutoPricingAutoPrivacyAutoPublicAutoPublic PagesAutoReferralAutoReferralsAutoReportsAutoResearchAutoSecretsAutoSerpAutoSSOAutoStorefrontsAutoSupportAutoTemplatesAutoToolsAutoTrackAutoUsageAutoUsage TagsAutoUserAutoWorkflowsAutoWorkspacesAutoWebhooksAuto
    OverviewPythonNode.jsCLI
    Guides OverviewJavaScript RenderingBrowser ActionsOutput FormatsPDF & OCRCachingWebhooksJSON Schema FilteringWebSocket Real-TimeBring Your Own ProxyProSticky SessionsProAuthenticated ScrapingNewHTTP Methods & BodiesNewStructured ExtractionAIWeb SearchAgent and RAG GroundingResearch JobsAgent RunsSite MappingWeb CrawlingBatch ScrapingSchedulerData MarketplaceSelling DataAgent OnboardingEmbeddingsKeyword IdeasAI VisibilityWorkflowsChange DetectionCloud Storage ExportSpend LimitsOrganizations & TeamsScrape TemplatesCustom ConnectorsSecretsContact ListsPlatform Sub-AccountsReferrals & AffiliatesAlerts & NotificationsExtraction ProfilesAIBYOK ExtractionAIOAuth2 Machine-to-MachineSupport & TicketsUnsupported Targets
    Tutorials OverviewStructured ExtractionAIE-commerce ScrapingNews MonitoringPrice MonitoringMulti-Page CrawlingMonitoring DashboardAI Agent / MCPMCPAI Research AgentAISite CrawlingData Pipeline to Cloud
    E-commerceLead GenerationChange MonitoringRAG & AI PipelinesAIResearch
    Reference OverviewPricingRate LimitsReliabilityReliability ContractError CodesChangelogVersioning
    Migrations OverviewFrom FirecrawlFrom ApifyFrom ScrapingBee / ScraperAPIFrom Crawl4AIFrom SpiderSearch to SERPFirecrawl v0 API ReferenceLegacy
    OverviewMCP ServerAIn8n NodeLangChainAICrewAIAILlamaIndexAISupabaseChrome ExtensionSoon
    PlaygroundPricingStatus

    Up to 5,000 free requests · No credit card

    API Reference

    Domain Stats API

    Check how well AlterLab retrieves a domain before you scrape it. No API key is needed.

    Published domains only

    Stats exist for domains with enough measured traffic. Any other domain returns HTTP 404 with Domain not published.

    GET /api/v1/domains/{domain}/public-stats

    curl https://api.alterlab.io/api/v1/domains/example.com/public-stats
    • success_rate: measured success rate, 0 to 1.
    • sample_size and window_days: requests measured and the length of the window.
    • typical_tier, median_latency_ms, antibot_vendor: the usual tier, latency and detected protection.
    • formats: output formats that work for the domain.
    • listings: matching Data Marketplace listings, when any exist.
    • updated_at: when the snapshot was computed.

    GET /api/v1/domains/public-stats

    Lists published domains, highest sample size first. Use the limit query parameter (1 to 2000, default 500). The response is { domains, total }.

    GET /api/v1/domains/{domain}/profile

    Free and keyless. A measured, read-only profile of how a domain behaves, also available as the MCP tool alterlab_site_profile. AlterLab still chooses the tier, proxy and pace for every request; nothing reads this profile to route.

    curl https://api.alterlab.io/api/v1/domains/example.com/profile
    • success_rate, typical_tier, median_latency_ms, antibot_vendor: measured over unauthenticated jobs.
    • typical_cost_microcents and typical_cost_usd: median cost of a successful request.
    • common_failures: list of code, share (of failed requests) and retryable.
    • sample_size, window_days, window_start, window_end and updated_at; field_samples gives the sample size behind each field. A field without enough samples is omitted, never estimated.

    An unknown or unpublished domain returns HTTP 200 with known: false and an estimate object pointing at the free POST /api/v1/scrape/estimate/public path.

    Last updated: June 2026

    On this page