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/exports/domains/1m/latest"

# 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. Selective current filters return a lower-bound total and hasMore instead of running an expensive exact count.

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

GET/api/v1/rankings/export

Redirect to the latest immutable domain-ranking gzip CSV archive (1M or broader current 10M edition).

?scope=10m&format=csv

GET/api/v1/hosts

Browse current hostname rankings.

GET/api/v1/hosts/export

Redirect to the latest immutable hostname-ranking gzip CSV archive (1M or broader current 10M edition).

?scope=10m&format=csv

GET/api/v1/ips

Browse all-observed IPv4 or IPv6 rankings ordered by observation hits and recency.

?version=4&sort=hits&page=1&limit=100

GET/api/v1/ips/export

Redirect to the latest immutable Top-1M IPv4 or IPv6 gzip CSV archive, ordered by hits.

?version=6&scope=1m&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 and observed URLs.

?q=google

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

List URLs observed on a domain's hosts.

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

Pivot between a domain, resource-provider domains, loading domains, and ordinary hyperlinks.

Research

GET/api/v1/technologies

Browse current technologies ranked by observed domain count (scope=1m; other scopes return unsupported_scope).

GET/api/v1/tech/{slug}

Get a current technology profile and exact observed domain count, with up to 10,000 ranked domain examples.

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. Canonical crypto views use wallet names and analytics views may be provider-specific; legacy *_addresses API types remain compatible.

?page=1&limit=100

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

Export up to 100,000 current list rows as CSV. Wallet and provider-specific views are aliases over the current published generation.

GET/api/v1/observables/{id}

Get a non-URL supporting-list observable and its current usage statistics.

GET/api/v1/observables/{id}/domains

Get a bounded top-ranked domain sample currently associated with a non-URL observable.

?limit=100

GET/api/v1/observables/{id}/hosts

Get a bounded top-ranked host sample currently associated with a non-URL observable.

?limit=100

GET/api/v1/urls

Search observed URLs across supported URL types.

?q=example.js&type=javascript

GET/api/v1/urls/{id}

Get an observed URL profile with bounded source and technology pivots.

GET/api/v1/urls/{id}/domains

Find ranked domains observed using a URL.

?page=1&limit=100

GET/api/v1/urls/{id}/hosts

Find ranked hosts observed using a URL.

?page=1&limit=100

GET/api/v1/hosts/{fqdn}/urls

List URLs observed on a hostname.

GET/api/v1/analytics

Search observed analytics identifiers with an optional provider filter.

?q=G-ABC123&provider=google_analytics_4

GET/api/v1/analytics/{id}

Get an observed analytics identifier and bounded usage statistics.

GET/api/v1/analytics/{id}/domains

Find ranked domains observed with an analytics identifier.

GET/api/v1/analytics/{id}/hosts

Find ranked hosts observed with an analytics identifier.

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

List analytics identifiers observed on a domain.

GET/api/v1/hosts/{fqdn}/analytics

List analytics identifiers observed on a hostname.

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

List current non-URL observables, including wallets and markup signals, associated with a domain.

?category=crypto&page=1&limit=100

GET/api/v1/hosts/{fqdn}/observables

List current non-URL observables associated with a hostname.

?type=bitcoin_address&page=1&limit=100

GET/api/v1/dns/{rrtype}/{value}

Get retained MX or NS observation statistics for an exact server name.

GET/api/v1/dns/{rrtype}/{value}/domains

Find ranked domains observed using an exact MX or NS server.

?page=1&limit=100

GET/api/v1/dns/{rrtype}/{value}/hosts

Find ranked hostnames observed using an exact MX or NS server.

?page=1&limit=100

GET/api/v1/hosts/{fqdn}

Get a current hostname profile and rank.

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 previously ranked domains explicitly confirmed absent by a registry.

GET/api/v1/expired/export

Export registry-confirmed expired domains.

GET/api/v1/renewed

Browse names observed registered again after a confirmed absence.

GET/api/v1/renewed/export

Export the compact re-registered-domain transition ledger.

GET/api/v1/expiring

Browse previously ranked domains approaching or passing their expected expiry.

GET/api/v1/expiring/export

Export current expiring-domain candidates.

GET/api/v1/exports

List immutable daily archive files and checksums.

GET/api/v1/exports/{dataset}/{scope}/{edition}

Download a latest or immutable dated ranking archive. Dataset is domains, hosts, ipv4, or ipv6; edition is latest or YYYYMMDD.

/api/v1/exports/domains/1m/latest

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.