Query the world's largest WHOIS database through a simple REST API. Access 5.40 billion historical records, daily snapshots of every new registration, and real-time domain intelligence across 4,198 TLDs — through 79 purpose-built endpoints.
The API is organized into 10 functional categories, each addressing a different part of the WHOIS intelligence workflow. Whether you need a single-domain lookup, reverse WHOIS search, historical snapshots, or bulk monitoring, there's a dedicated endpoint.
All endpoints authenticate via an API key passed as a Bearer token in theAuthorization header. Obtain your key from the dashboard. Keys are tied to your account and count against your plan's rate limit.
Include this header on every request:
Authorization: Bearer whoisdc_live_abc123def456...
Your first API call — look up a real domain's WHOIS record:
# Your first request curl -X GET "/whois?domain=example.com" \ -H "Authorization: Bearer YOUR_API_KEY"
All endpoints return application/json by default. Pass &format=xml or&format=csv to change the output. Timestamps are ISO 8601 in UTC.
The foundational endpoints for fetching current, live, historical, and parsed WHOIS records.
Returns the latest saved WHOIS record for a domain.
Who owns google.com today?
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/whois?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/whois?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Fetches fresh WHOIS data directly from the registry in real time.
Get the newest info for google.com straight from the registry.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/whois/live?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/whois/live?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns archived WHOIS records collected over past years.
See who owned a domain back in 2015.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/whois/historical?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/whois/historical?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Shows a chronological timeline of WHOIS field changes.
Track every ownership change over time.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/whois/timeline?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/whois/timeline?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns raw WHOIS text converted into clean, structured JSON fields.
Turn the raw WHOIS block into easy-to-read JSON.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/whois/parsed?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/whois/parsed?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the original WHOIS text exactly as stored.
Show the full raw WHOIS text block.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/whois/raw?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/whois/raw?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Find every domain linked to a given attribute — email, phone, name, company, nameserver, and more.
Returns all domains linked to a given email address.
Find all domains owned by [email protected].
[email protected]. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./email?email=john%40yahoo.com"com"># Email lookup — JSON curl -X GET "/[email protected]" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns all domains linked to a given phone number.
Find domains linked to +919999999999.
919999999999. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./phone?phone=919999999999"com"># Phone lookup — JSON curl -X GET "/phone?phone=919999999999" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns all domains linked to a registrant name.
Find domains owned by Amit Singh.
Amit Singh. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./name?name=Amit%20Singh"com"># Name lookup — JSON curl -X GET "/name?name=Amit Singh" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns all domains registered under a company name.
Find all domains owned by Google LLC.
Google LLC. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./company?company=Google%20LLC"com"># Company lookup — JSON curl -X GET "/company?company=Google LLC" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Full-text search across WHOIS records by keyword.
Find WHOIS records containing 'crypto'.
crypto. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./keyword?keyword=crypto"com"># Keyword lookup — JSON curl -X GET "/keyword?keyword=crypto" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns all domains using a given nameserver.
Find domains using ns1.cloudflare.com.
ns1.cloudflare.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./nameserver?nameserver=ns1.cloudflare.com"com"># Nameserver lookup — JSON curl -X GET "/nameserver?nameserver=ns1.cloudflare.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns all domains sharing the same DNS / nameserver value.
Find domains pointing to the same DNS.
ns1.cloudflare.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./dns?nameserver=ns1.cloudflare.com"com"># Nameserver lookup — JSON curl -X GET "/dns?nameserver=ns1.cloudflare.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the EPP (Extensible Provisioning Protocol) status codes for a domain.
Check EPP status of yahoo.com.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./epp?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/epp?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Searches the WHOIS database by domain name.
Look up WHOIS records for yahoo.com.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the most recent WHOIS snapshot stored for a domain.
Get the newest saved snapshot for yahoo.com.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/latest?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/latest?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns all domains linked to a registrant street address.
Find domains registered at 1600 Amphitheatre Parkway.
1600 Amphitheatre Parkway. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./address?address=1600%20Amphitheatre%20Parkway"com"># Address lookup — JSON curl -X GET "/address?address=1600 Amphitheatre Parkway" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Atomic queries for specific WHOIS attributes — ownership, contacts, privacy, status, dates, and age.
Returns current registrant / owner info.
See who owns amazon.com.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/ownership?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/ownership?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns admin, tech, and billing contact details.
Get the admin contact of a domain.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/contact?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/contact?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns registrar name, URL, and WHOIS server.
See which company registered the domain.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/registrar?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/registrar?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns registered owner details including country.
View owner country, email, and company.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/registrant?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/registrant?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Detects whether WHOIS privacy protection is active.
Check if a domain is privacy protected.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/privacy?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/privacy?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Checks whether a WHOIS record exists for a domain.
Check if a domain has WHOIS data.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/availability?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/availability?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the current domain status (active, expired, etc.).
Check if a domain is active or expired.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/whois-status?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/whois-status?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the domain expiry / expiration date.
Find the expiry date of facebook.com.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/expiry?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/expiry?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the date the domain was first registered.
See the original registration date.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/creation-date?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/creation-date?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the date the WHOIS record was last updated.
See the latest WHOIS update date.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/updated-date?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/updated-date?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Calculates how many years / days old the domain is.
This domain was created 15 years ago.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/age?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/age?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Detects whether WHOIS fields changed since the last check.
Check if the owner changed recently.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/change-detection?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/change-detection?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Query the archive across time — snapshots, diffs, ownership chains, and field-level history.
Compares two WHOIS snapshots for a domain at different dates and returns changed fields.
Compare WHOIS data from 2020 vs 2025.
yahoo.com. Pass as a URL-encoded query parameter.2020-01-01. Pass as a URL-encoded query parameter.2025-01-01. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/diff?domain=yahoo.com&from=2020-01-01&to=2025-01-01"com"># Domain lookup — JSON curl -X GET "/domain/diff?domain=yahoo.com&from=2020-01-01&to=2025-01-01" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the WHOIS record closest to a given date.
What did the WHOIS look like on Jan 1 2020?
yahoo.com. Pass as a URL-encoded query parameter.2020-01-01. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/snapshot?domain=yahoo.com&date=2020-01-01"com"># Domain lookup — JSON curl -X GET "/domain/snapshot?domain=yahoo.com&date=2020-01-01" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the full chain of past registrant changes.
View every owner this domain ever had.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/ownership-history?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/ownership-history?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns the source registry that provided the WHOIS data.
Find which registry supplied the data.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/registry-source?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/registry-source?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns TLD-level metadata derived from the domain's WHOIS.
Get TLD details for yahoo.com.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/tld-info?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/tld-info?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns a history of nameserver changes for a domain.
Track all nameserver changes over time.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/nameserver-history?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/nameserver-history?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns a history of registrar changes for a domain.
See when the domain moved from GoDaddy to Namecheap.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/registrar-history?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/registrar-history?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns a history of registrant email changes.
See all past owner emails.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/email-history?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/email-history?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns a history of registrant phone number changes.
Track phone number changes over time.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/phone-history?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/phone-history?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns a history of company / organisation changes.
See all company names ever associated.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/company-history?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/company-history?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns a history of registrant country changes.
See if the domain moved to a different country.
yahoo.com. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domain/country-history?domain=yahoo.com"com"># Domain lookup — JSON curl -X GET "/domain/country-history?domain=yahoo.com" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Submit large batches — up to thousands of domains per request — for cost-efficient processing.
Returns WHOIS records for a list of domains.
Look up 1,000 domains in one request.
{"domains":["yahoo.com","openai.com"]}json, xml, csv. Defaults to json./bulk/lookup"com"># POST with JSON body curl -X POST "/bulk/lookup" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com"]}'
Returns historical WHOIS records for many domains.
Pull old WHOIS for 500 domains.
{"domains":["yahoo.com","openai.com"]}json, xml, csv. Defaults to json./bulk/historical"com"># POST with JSON body curl -X POST "/bulk/historical" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com"]}'
Finds domains linked to many emails, phones, or names at once.
Search many emails together.
{"items":["[email protected]","[email protected]"]}json, xml, csv. Defaults to json./bulk/reverse"com"># POST with JSON body curl -X POST "/bulk/reverse" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"items":["[email protected]","[email protected]"]}'
Exports bulk WHOIS results to CSV, JSON, or JSONL.
Export 10,000 WHOIS records to one CSV file.
{"tld":"com","from":"2025-01-01","to":"2025-12-31"}json, xml, csv. Defaults to json./bulk/export"com"># POST with JSON body curl -X POST "/bulk/export" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tld":"com","from":"2025-01-01","to":"2025-12-31"}'
Starts WHOIS change monitoring for many domains.
Monitor 5,000 domains for owner or registrar changes.
{"domains":["yahoo.com","openai.com","cloudflare.com"]}json, xml, csv. Defaults to json./bulk/monitoring"com"># POST with JSON body curl -X POST "/bulk/monitoring" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com","cloudflare.com"]}'
Reports which domains in a batch have changed since last check.
Check 2,000 domains and see which changed.
{"domains":["yahoo.com","openai.com","cloudflare.com"]}json, xml, csv. Defaults to json./bulk/change-detection"com"># POST with JSON body curl -X POST "/bulk/change-detection" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com","cloudflare.com"]}'
Fetches real-time WHOIS from registries for many domains.
Get live WHOIS for 500 domains right now.
{"domains":["yahoo.com","openai.com","cloudflare.com"]}json, xml, csv. Defaults to json./bulk/live-lookup"com"># POST with JSON body curl -X POST "/bulk/live-lookup" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com","cloudflare.com"]}'
Returns structured, parsed WHOIS fields for many domains.
Get clean JSON WHOIS for 2,000 domains.
{"domains":["yahoo.com","openai.com","cloudflare.com"]}json, xml, csv. Defaults to json./bulk/parsed"com"># POST with JSON body curl -X POST "/bulk/parsed" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com","cloudflare.com"]}'
Returns the original raw WHOIS text for many domains.
Download raw WHOIS text for 1,000 domains.
{"domains":["yahoo.com","openai.com","cloudflare.com"]}json, xml, csv. Defaults to json./bulk/raw"com"># POST with JSON body curl -X POST "/bulk/raw" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com","cloudflare.com"]}'
Returns WHOIS snapshots for many domains at a specific date.
Get WHOIS of 500 domains exactly on 2020-01-01.
{"domains":["yahoo.com","openai.com"],"date":"2020-01-01"}json, xml, csv. Defaults to json./bulk/snapshot"com"># POST with JSON body curl -X POST "/bulk/snapshot" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domains":["yahoo.com","openai.com"],"date":"2020-01-01"}'
Daily streams of newly registered, expiring, and updated domains.
Returns a paginated list of newly registered domains for a given date.
See all domains registered today.
2026-05-14. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./nrd?date=2026-05-14"com"># Date/TLD lookup — JSON curl -X GET "/nrd?date=2026-05-14" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns domains that are expiring on or around the given date.
See domains expiring this week.
2026-05-14. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./expiring?date=2026-05-14"com"># Date/TLD lookup — JSON curl -X GET "/expiring?date=2026-05-14" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns domains whose WHOIS records were updated on the given date.
See WHOIS updates for today.
2026-05-14. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./updated?date=2026-05-14"com"># Date/TLD lookup — JSON curl -X GET "/updated?date=2026-05-14" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Returns a bare list of domain names without full WHOIS data.
Get a plain domain list for a given date.
2026-05-14. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./domains-only?date=2026-05-14"com"># Date/TLD lookup — JSON curl -X GET "/domains-only?date=2026-05-14" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Full-text and batch search across the 5.40 billion record WHOIS archive.
Full-text search across WHOIS fields. Optionally narrow to a specific field.
Find all WHOIS records mentioning 'crypto'.
crypto. Pass as a URL-encoded query parameter.registrant_company. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter.0. Pass as a URL-encoded query parameter.json, xml, csv. Defaults to json./search/whois?q=crypto&field=registrant_company&size=10&page=0"com"># Filter lookup — JSON curl -X GET "/search/whois?q=crypto&field=registrant_company&size=10&page=0" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Run up to 100 full-text WHOIS searches in a single request.
Search 50 company names at once.
{"queries":["Google LLC","Cloudflare Inc","OpenAI"]}json, xml, csv. Defaults to json./search/whois/batch"com"># POST with JSON body curl -X POST "/search/whois/batch" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"queries":["Google LLC","Cloudflare Inc","OpenAI"]}'
Watch domains for WHOIS changes and receive alerts when ownership or key fields update.
Registers a domain for ongoing WHOIS change monitoring. Captures a baseline snapshot and stores a monitoring job.
Start watching yahoo.com for owner or nameserver changes.
{"domain":"yahoo.com","frequency":"daily","notifyEmail":"[email protected]"}json, xml, csv. Defaults to json./monitoring/whois"com"># POST with JSON body curl -X POST "/monitoring/whois" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"yahoo.com","frequency":"daily","notifyEmail":"[email protected]"}'
Compares the latest WHOIS against the stored baseline and returns any changed fields.
Check if yahoo.com ownership changed since last check.
{"domain":"yahoo.com"}json, xml, csv. Defaults to json./monitoring/alerts"com"># POST with JSON body curl -X POST "/monitoring/alerts" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"domain":"yahoo.com"}'
Download daily ZIP archives of domain datasets — newly registered, expiring, updated, dropped, and more.
Downloads a ZIP archive of newly registered domains for a date.
Download all new domains for today.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/nrd?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/nrd?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Downloads a ZIP archive of domains with WHOIS updates for a date.
Download updated domains for today.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/updated?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/updated?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Downloads a ZIP archive of expiring domains for a date.
Download expiring domains for a date.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/expiring?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/expiring?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Downloads domains where WHOIS privacy protection was recently lifted.
Domains where proxy was removed yesterday.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/proxy-removed?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/proxy-removed?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Downloads the clean domain dataset (proxy-removed).
Get clean domains for a date.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/proxy?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/proxy?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Downloads domains grouped by their WHOIS creation date.
Download all domains created on a specific date.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/create-date-domains?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/create-date-domains?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Downloads domains grouped by their WHOIS query timestamp.
Download domains queried on a specific date.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/querytime-domains?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/querytime-domains?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Downloads a list of available / free domains.
Get available domain names for today.
2026-05-14. Pass as a URL-encoded query parameter.YOUR_API_KEY. Pass as a URL-encoded query parameter./download/free-domains?date=2026-05-14&apiKey=YOUR_API_KEY"com"># Date/TLD lookup — JSON curl -X GET "/download/free-domains?date=2026-05-14&apiKey=YOUR_API_KEY" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Crawl-derived domain attributes — blacklist status, robots.txt, HTTP status codes, CMS, web server, mail servers, rank, domain-name variants, and full SSL certificate detail.
Domains flagged as blacklisted by the crawler.
List domains currently flagged as blacklisted.
1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/blacklisted-domains?search=&page=1&pageSize=10"com"># Filter lookup — JSON curl -X GET "/actes-insights/blacklisted-domains?search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Domains filtered by whether they have a robots.txt file, and whether it disallows crawling.
Find domains with no robots.txt at all.
missing. Pass as a URL-encoded query parameter.1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/robots-txt?status=missing&search=&page=1&pageSize=10"com"># Filter lookup — JSON curl -X GET "/actes-insights/robots-txt?status=missing&search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Domains filtered by the HTTP status code observed on last crawl.
Find every domain returning a 404.
404. Pass as a URL-encoded query parameter.1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/status-codes?code=404&search=&page=1&pageSize=10"com"># Filter lookup — JSON curl -X GET "/actes-insights/status-codes?code=404&search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Domains filtered by detected CMS (and version, where known).
Find domains running WordPress.
WordPress. Pass as a URL-encoded query parameter.1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/cms?value=WordPress&search=&page=1&pageSize=10"com"># Registrant data lookup — JSON curl -X GET "/actes-insights/cms?value=WordPress&search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
The most common detected CMS platforms, ranked by domain count.
Which CMS platforms are most common?
/actes-insights/cms/top-values"com"># Lookup lookup — JSON curl -X GET "/actes-insights/cms/top-values" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Domains filtered by detected web server software.
Find domains running nginx.
nginx. Pass as a URL-encoded query parameter.1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/web-server?value=nginx&search=&page=1&pageSize=10"com"># Registrant data lookup — JSON curl -X GET "/actes-insights/web-server?value=nginx&search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
The most common detected web servers, ranked by domain count.
Which web servers are most common?
/actes-insights/web-server/top-values"com"># Lookup lookup — JSON curl -X GET "/actes-insights/web-server/top-values" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Domains filtered by their MX record host.
Find domains using a specific mail provider's MX host.
mailstore1.secureserver.net.. Pass as a URL-encoded query parameter.1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/mx?value=mailstore1.secureserver.net.&search=&page=1&pageSize=10"com"># Registrant data lookup — JSON curl -X GET "/actes-insights/mx?value=mailstore1.secureserver.net.&search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
The most common MX record hosts, ranked by domain count.
Which mail servers are most common?
/actes-insights/mx/top-values"com"># Lookup lookup — JSON curl -X GET "/actes-insights/mx/top-values" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Domains ordered by their MXY rank (lower is better).
List the top-ranked domains.
1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/mxy-rank?search=&page=1&pageSize=10"com"># Filter lookup — JSON curl -X GET "/actes-insights/mxy-rank?search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Domain names without their TLD, ranked by how many TLD variants exist for each.
Which domain names exist across the most TLDs?
1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/domain-prefixes?search=&page=1&pageSize=10"com"># Filter lookup — JSON curl -X GET "/actes-insights/domain-prefixes?search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
The actual full domains sharing one name prefix across different TLDs.
List every TLD variant of "nic".
1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/domain-prefixes/{prefix}?page=1&pageSize=10"com"># Filter lookup — JSON curl -X GET "/actes-insights/domain-prefixes/{prefix}?page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Per-domain SSL certificate detail — subject, issuer, key algorithm, cipher, and expiry.
Find every domain issued a certificate by a specific issuer.
Google Trust Services. Pass as a URL-encoded query parameter.1. Pass as a URL-encoded query parameter.10. Pass as a URL-encoded query parameter./actes-insights/ssl-certificates?issuer=Google%20Trust%20Services&search=&page=1&pageSize=10"com"># Filter lookup — JSON curl -X GET "/actes-insights/ssl-certificates?issuer=Google Trust Services&search=&page=1&pageSize=10" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Limits are enforced per API key across three rolling windows (per minute, per hour, per day) and concurrent in-flight requests. Exceeding any window returns 429 Too Many Requests.
| Plan | Req / min | Req / hour | Req / day | Concurrent | Notes |
|---|---|---|---|---|---|
| Starter | 60 | 5,000 | 50,000 | 5 | Small companies |
| Pro | 180 | 20,000 | 250,000 | 15 | Heavy API users |
| Business | 500 | 100,000 | 1,000,000 | 30 | Large usage |
| Enterprise | Custom | Custom | Custom | Custom | Dedicated limits |
Every response includes rate-limit headers:
X-RateLimit-Limit: 5000 # Cap for current window X-RateLimit-Remaining: 3200 # Calls left before throttle X-RateLimit-Reset: 1713890000 # Unix ts when window resets
| Code | Meaning | Resolution |
|---|---|---|
| 200 | Success | — |
| 400 | Bad Request | Check required parameters. |
| 401 | Unauthorized | API key missing or invalid. |
| 402 | Payment Required | Credits exhausted. |
| 404 | Not Found | Domain or record not in database. |
| 429 | Rate Limited | Too many requests. Wait X-RateLimit-Reset. |
| 500 | Server Error | Temporary. Retry with exponential backoff. |
| Language | Package | Install |
|---|---|---|
| Python | marketxy-py | pip install marketxy |
| Node.js | @marketxy/sdk | npm install @marketxy/sdk |
| Go | go-marketxy | go get github.com/marketxy/go-sdk |
| PHP | marketxy/sdk | composer require marketxy/sdk |
| Ruby | marketxy | gem install marketxy |