API Documentation

Programmatic access to current rankings, website observations, and immutable daily archives. Public read endpoints require no API key and use fair-use rate limits to protect availability. See the OpenAPI contract for a machine-readable index.

Quickstart

# Public read endpoints require no key
curl https://top1m.org/api/v1/domains/google.com

# Current domain ranking export
curl -L "https://top1m.org/api/v1/rankings/export?format=csv&scope=1m"

# Immutable daily archive catalog
curl https://top1m.org/api/v1/exports

Open access

Use the API for interactive queries. For large or reproducible datasets, prefer checksummed files from the daily archive.

Endpoints

Rankings

GET/api/v1/rankings

Search current or dated domain rankings.

?scope=1m&page=1&limit=100

GET/api/v1/rankings/export

Stream the current domain ranking as CSV or JSON.

?scope=1m&format=csv

GET/api/v1/hosts

Browse current hostname rankings.

GET/api/v1/hosts/export

Export current hostname rankings.

?scope=1m&format=csv

GET/api/v1/ips

Browse independent IPv4 or IPv6 rankings.

?version=4&mode=current&page=1&limit=100

GET/api/v1/ips/export

Export IPv4 or IPv6 rankings.

?version=6&mode=current&format=csv

Domains

GET/api/v1/domains/{name}

Get a current domain profile and rank.

GET/api/v1/domains/{name}/history

Get published daily rank history.

POST/api/v1/domains/bulk-lookup

Compare up to 1,000 domains without modifying the index.

GET/api/v1/search

Search indexed domain names.

?q=google

Research

GET/api/v1/technologies

Browse technologies ranked by observed domain count.

GET/api/v1/tech/{slug}

Get a technology profile and observed domains.

GET/api/v1/contacts

Search observed public email and phone signals.

GET/api/v1/contacts/{value}/domains

Find ranked domains associated with a contact signal.

GET/api/v1/lists

List current public web-observable leaderboards.

GET/api/v1/lists/{type}

Browse a current Top-1M supporting list.

?page=1&limit=100

GET/api/v1/lists/{type}/export

Export up to 100,000 current list rows as CSV.

Domain intelligence

GET/api/v1/whois/{name}

Return the latest available cached WHOIS profile.

GET/api/v1/links/{name}

Return current inbound and outbound crawl links.

GET/api/v1/pdns/{name}

Return observed DNS records for a domain.

GET/api/v1/pdns/ip/{ip}

Find domains observed on an IP address.

GET/api/v1/ips/{address}

Get an IP profile and hosted-domain observations.

Lifecycle and archives

GET/api/v1/expired

Browse domains dropped from the ranking.

GET/api/v1/expired/export

Export dropped domains.

GET/api/v1/expiring

Browse registration lifecycle observations.

GET/api/v1/expiring/export

Export registration lifecycle observations.

GET/api/v1/exports

List immutable daily archive files and checksums.

Playground

Runs a live public GET request from your browser.

GET

Rate limits

Limits vary by endpoint cost. Clients should cache responses, use pagination, back off after HTTP 429, and use daily downloads instead of repeatedly reconstructing complete datasets through paginated requests.