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_sizeandwindow_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_microcentsandtypical_cost_usd: median cost of a successful request.common_failures: list ofcode,share(of failed requests) andretryable.sample_size,window_days,window_start,window_endandupdated_at;field_samplesgives 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.