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
    Auto-generated

    Domains

    API reference for domains endpoints.

    Auto-generated

    This page was generated from the OpenAPI spec. Runmake generate-docs to refresh after spec changes.

    GET /api/v1/domains/census

    GET
    /api/v1/domains/census

    List Domain Census

    Parameters

    NameTypeRequiredDescription
    limitintegerOptionallimitDefault: 2000

    Request Example

    Bash
    curl -X GET https://api.alterlab.io/api/v1/domains/census \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Response Example

    JSON
    {
  "status": "ok"
}

    GET /api/v1/domains/census/report

    GET
    /api/v1/domains/census/report

    Get Census Report

    Request Example

    Bash
    curl -X GET https://api.alterlab.io/api/v1/domains/census/report \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Response Example

    JSON
    {
  "measured_domains": 0,
  "measured_on": "example",
  "vendor_share": {},
  "by_rank_bucket": {},
  "by_server_class": {},
  "challenged_at_lowest_tier": 0
}

    GET /api/v1/domains/census/report.csv

    GET
    /api/v1/domains/census/report.csv

    Get Census Report Csv

    Request Example

    Bash
    curl -X GET https://api.alterlab.io/api/v1/domains/census/report.csv \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Response Example

    JSON
    {
  "status": "ok"
}

    GET /api/v1/domains/public-stats

    GET
    /api/v1/domains/public-stats

    List Domain Public Stats

    Parameters

    NameTypeRequiredDescription
    limitintegerOptionallimitDefault: 500

    Request Example

    Bash
    curl -X GET https://api.alterlab.io/api/v1/domains/public-stats \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Response Example

    JSON
    {
  "domains": [],
  "total": 0
}

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

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

    Get Domain Census

    Parameters

    NameTypeRequiredDescription
    domainstring
    Required
    		domain

    Request Example

    Bash
    curl -X GET https://api.alterlab.io/api/v1/domains/<domain>/census \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Response Example

    JSON
    {
  "domain": "example",
  "rank": 0,
  "status_code": "example",
  "vendor": "example",
  "challenge_at_tier": true,
  "tier": 0
}

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

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

    Get Domain Site Profile

    Parameters

    NameTypeRequiredDescription
    domainstring
    Required
    		domain

    Request Example

    Bash
    curl -X GET https://api.alterlab.io/api/v1/domains/<domain>/profile \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Response Example

    JSON
    {
  "known": true,
  "domain": "example",
  "window_days": "example",
  "window_start": "example",
  "window_end": "example",
  "sample_size": "example"
}

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

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

    Get Domain Public Stats

    Parameters

    NameTypeRequiredDescription
    domainstring
    Required
    		domain

    Request Example

    Bash
    curl -X GET https://api.alterlab.io/api/v1/domains/<domain>/public-stats \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Response Example

    JSON
    {
  "domain": "example",
  "window_days": 0,
  "window_start": "example",
  "window_end": "example",
  "sample_size": 0,
  "success_rate": 0
}
    Last updated: June 2026

    On this page