The DomainKits REST API provides programmatic access to domain intelligence data. Search newly registered, aged, expired, and deleted domains. Look up WHOIS records, reverse nameserver queries, and download NRDs zone files. API access requires a Premium or higher plan, except NRDs Download, which is available on every plan.
Responses contain no personal data. WHOIS results are limited to registrar, dates, status codes and nameservers; registrant names, emails, addresses and phone numbers are not returned.
Include your API key in every request. API keys are the same keys used for the DomainKits MCP Server.
Authorization: Bearer dk_xxx
X-API-Key: dk_xxx
The API is versioned in the URL path (/api/v1). Customer-visible changes are listed in the Changelog.
Customer-visible changes, newest first. Items marked Action required change what your existing code receives without changing the response shape, so they will not surface as a parse error.
/nrds/download is available on every plan (was Premium and Platinum). The files and the days of history depend on your plan, the same as on the download page; see NRDs Download. All other endpoints still require Premium or Platinum./nrds/download covers the last 30 days, the same as the download page; an older date returns 403./nrds/download: each file can be downloaded up to 10 times per account in total, on every plan, the same as on the download page (was 10 times per day per API key, and unlimited on Platinum). Further requests for that file return 429./nrds/download without date returns the latest daily file (was today's date, which returned 404 until that day's file was ready)./nrds/download: a file that does not exist returns 404 before the plan is checked, so type=full_whois for a TLD with no file that day returns 404 instead of 403.sort, limit, offset and position; a min/max or start/end pair counts as one; a request with no parameters uses 1. Applies to /search/nrds, /search/aged, /search/active, /search/expired, /search/deleted and /search/market.limit returns 100 rows; use offset to read further. Applies to the same six search endpoints./ns-reverse, /monitor/changes, /typosquat, /ct/subdomains and /ct/certs. If either kind is short, the request returns 429 and nothing is used./search/expired: the has_hold parameter and the hold field have been removed. Requests that still send has_hold return 400; remove it from your integration./search/expired: registrar_name keeps only domains whose registrar name contains the given text (case-insensitive, e.g. namecheap), and each row carries registrar_name, also in the CSV column where hold was./search/nrds: ns keeps only domains that use a nameserver (a domain such as cloudflare.com covers every host under it; a host such as ns1.example.com matches only itself), and exclude_ns leaves out domains that use any of up to 10 nameservers./search/nrds: each row carries nameservers (hosts joined by ;), also the last CSV column./search/nrds, /search/active, /search/market: gtld=false returns country-code TLDs only, and cctld=false returns generic TLDs only./search/active: cctld keeps only the country-code TLDs you list (e.g. ai,io); each code also covers its second-level suffixes./search/nrds-live has been removed. Remove calls to it from your integration./search/nrds: country-code coverage grows from 13 to 112 codes, listed in NRDs Country Codes. Codes that returned 400 in tld or cctld before, such as jp or za, are now accepted./nrds/download on Premium: files for country-code TLDs outside NRDs Country Codes return 403, and so does the all-TLD file on a date whose data includes such TLDs./search/hostname replaces /ct/search: keyword search over hostnames that received a certificate in a time window of up to 24 hours. Moving from /ct/search: the keyword goes in q, rows carry hostname, reg_domain and issuretime, field=sld now matches the subdomain part, and sort and export are not available. It has its own credits, listed under Credits./search/nrds: cctld keeps only the country-code TLDs you list (e.g. ai,io); each code also covers its second-level suffixes, and generic TLDs are not affected.429 messages no longer mention a trial.components (the word split of the name) is no longer returned by /search/nrds, /search/nrds-live, /search/aged, /search/deleted, /search/market and /monitor/changes, in JSON or as a CSV export column./search/nrds: in tld, a two-letter country code such as br now returns the whole family (com.br, net.br and so on); a dotted suffix such as com.br still matches only itself. Before, tld=br returned nothing./search/nrds: country-code coverage is ai, io, si, co, sh, so, cc, br, mx, cl, gg, id and my. Any other country-code TLD in tld or cctld returns 400 instead of an empty result./search/nrds: a parameter that is not listed in this reference returns 400 with parameter "…" is not allowed./ct/search has been removed. Remove calls to it from your integration./safety has been removed. Remove calls to it from your integration./ns-reverse: ns accepts up to 10 comma-separated nameservers and returns the domains that use all of them. The other filters apply on top of the intersection. A comma in tld still means any of the listed TLDs./ns-reverse: parameter values are no longer cut at 300 characters. A long ns or exclude_query list could previously lose its tail and return results for a filter you did not write./whois, /bulk/whois: registrar_name now returns the registrar's complete name. Names containing a comma were previously cut at the comma (Cloudflare where the registrar is Cloudflare, Inc.). Roughly a third of registrars are affected. Review any exact string matching on this field./bulk/whois: an entry whose lookup did not reach a conclusion now carries resolved: false and no registered key, instead of registered: false. A failed lookup and an unregistered domain used to be indistinguishable. Treat a missing registered as unknown, never as available. This is the same shape as the existing supported: false./typosquat accepts internationalized domains in Unicode (hellocafé.com) or punycode (xn--hellocaf-i1a.com) form. A new variant class ascii-fold returns the accent-dropped lookalikes (hellocafe.com), which is the most common way such a name is spoofed. Variants that are themselves internationalized carry a unicode field next to the punycode domain. Fourteen classes in total./whois, /dns, /safety and both /bulk endpoints accept internationalized domain names in Unicode form. Responses use the punycode form./dns: large record sets are no longer truncated. Domains with long TXT sets now return the complete set; some of them previously returned no TXT records at all./whois: results are no longer served from a short-lived cache. Data is fresher, and a repeated lookup of the same domain takes slightly longer./tld-check: when the lookup cannot complete, the endpoint returns an error instead of an empty result. An empty result previously read as "this prefix is available in every TLD"./ct/search: the maximum limit is 500. Higher values now return 400 instead of being silently reduced, so a request for 5000 rows fails loudly rather than coming back with 500./ct/search: issuer, after, before and cert_type are no longer accepted. They were taken but never applied, so a request using them was not filtered the way it looked. Use since and until for the time window./ct/search: since and until bound the time window (until is exclusive, unlike before on the other two CT endpoints). sort=scan is the order that supports stable paging./ct/search: responses carry complete and searched_since. complete: false means the rows are a prefix of the matches, not the full set./ct/certs: include_subdomains.request_id. A 429 carries Retry-After.YYYY-MM-DD HH:MM:SS as well as YYYY-MM-DD.X-CT-Complete: false, because the file itself looks identical to a complete one.503 instead of 404. The old 404 reported "no results" for a search that had not finished.The API uses standard HTTP status codes. Errors return a JSON object with success: false and an error message.
Search newly registered domains (last 60 days, refreshed continuously). Provide query for keyword search, tld without query to browse, or neither to page through the full dataset. The freshest rows (registered within the last hours, not yet in the daily datasets) carry live: true. They are included by default; pass live=false to leave them out. Unrecognized parameter names and values return 400.
Country-code TLDs covered: the 147 codes in NRDs Country Codes, 114 of them together with their second-level suffixes such as com.br or my.id. A country-code TLD outside that list in tld or cctld returns 400. In tld, a two-letter country code such as br returns the whole family (com.br, net.br and so on); a dotted suffix such as com.br matches only itself.
com or com,net,org). Results are the union. Without query, enters TLD browse mode.ai,io), case-insensitive. Each code also covers its second-level suffixes (br covers com.br, net.br and so on); other country-code results are left out; generic TLDs are not affected. Combined with tld, only suffixes in both are returned. The literal false (lowercase) leaves out every country-code TLD, so only generic TLDs remain. An empty value, or one that is neither false nor two-letter codes, returns 400. Available codes: the 147 in NRDs Country Codes; any other code returns 400.false leaves out every generic TLD, so only country-code TLDs remain; true is the same as omitting it. Only the literals true / false. Together with cctld=false, no rows are returned.start, end, middle. Requires query; omit to match anywhere.400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.YYYY-MM-DD, inclusive. Either side may be omitted.true / false; 1, 0, yes return 400. has_sale=true keeps only domains with a marketplace listing.example.com or example.co.uk matches every nameserver host equal to it or under it (ns1.example.com); a host such as ns1.example.com matches that host only. One value, case-insensitive; a trailing dot is ignored. A bare suffix (com, co.uk), a value without a dot, more than one value, or characters other than letters, digits, dots and hyphens return 400. Domains with no nameservers on record are not matched.ns rules. Domains with no nameservers on record are kept, so under the same other filters the ns=X and exclude_ns=X results together make up the full result.false restricts results to the daily datasets; true (same as omitting the parameter) returns the full data including the freshest rows. Only the literals true / false. To isolate the freshest rows, filter on the per-row live field.reg_date_desc (default) reg_date_asc length_asc length_desc period_asc period_desc tld_count_asc tld_count_desc alpha.export.domain, tld, created, expires, period, length, tld_count, for_sale (listing code, empty when not listed), live (true = registered within the last hours, flips to false once the daily datasets cover it), nameservers (nameserver hosts joined by ;, empty when none are on record). The field set is fixed; empty means no value.Search aged domains (5 to 20+ years of history). Provide query for keyword search, tld without query (comma-separated, up to 10), or neither to page through the full dataset. Unrecognized parameter names and values return 400.
query, enters TLD browse mode.start, end, middle. Requires query; omit to match anywhere.400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.true / false.age_desc (default) age_asc length_asc length_desc reg_date_asc reg_date_desc tld_count_asc tld_count_desc.domain, tld, created (full date), age (years), length, for_sale (listing code, empty when not listed), tld_countSearch active (currently registered) domains, 250M+ inventory. Two modes: provide query for keyword search, or provide tld without query (comma-separated, up to 10). Omitting both browses the full inventory across all TLDs. Unrecognized parameter names and values return 400.
On Premium, country-code TLDs are limited to the codes in NRDs Country Codes; a country-code TLD outside that list in tld or cctld returns 403.
query, enters TLD browse mode.ai,io), case-insensitive. Each code also covers its second-level suffixes (br covers com.br, net.br and so on); generic TLDs are not affected. Combined with tld, only suffixes in both are returned. The literal false (lowercase) leaves out every country-code TLD, so only generic TLDs remain. An empty value, or one that is neither false nor two-letter codes, returns 400.false leaves out every generic TLD, so only country-code TLDs remain; true is the same as omitting it. Only the literals true / false. Together with cctld=false, no rows are returned.start, end, middle. Requires query; omit to match anywhere.true / false.400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.length_asc (default) length_desc alpha tld_count_asc tld_count_desc.domain, tld, length, for_sale (listing code, empty when not listed), tld_countSearch expired domains (grace, redemption, pending delete). Provide query for keyword search, tld without query (comma-separated, up to 10), or neither to page through the full dataset. Unrecognized parameter names and values return 400.
query, enters TLD browse mode.start, end, middle. Requires query; omit to match anywhere.400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.expired, redemption, pending_delete.namecheap matches NameCheap Inc.. One value, up to 128 characters. Commas count as spaces and double quotes are ignored, so NameCheap, Inc. matches too. A value made only of commas, quotes or spaces returns 400; a name that matches nothing returns an empty result.YYYY-MM-DD, inclusive. Either side may be omitted.YYYY-MM-DD, inclusive. Use a recent start date to select fresh expiries.true / false.age_desc (default) age_asc length_asc length_desc tld_count_asc tld_count_desc.domain, tld, created, age, status (expired | redemption | pending_delete), auction_date, found_date, length, category, majestic, backlinks, registrar_name, tld_count. The field set is fixed; empty or null means no value.Search deleted (dropped) domains. Provide query for keyword search, tld without query (comma-separated, up to 10), or neither to page through the full dataset. Unrecognized parameter names and values return 400.
query, enters TLD browse mode.start, end, middle. Requires query; omit to match anywhere.400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.true / false.YYYY-MM-DD, inclusive. Use a recent start date to select fresh drops.true / false.age_desc (default) age_asc length_asc length_desc tld_count_asc tld_count_desc.domain, tld, age (years), reg_year, exp_year (year granularity), found_date, length, hold, tld_countSearch marketplace domains currently listed for sale. Provide query for keyword search, tld without query (comma-separated, up to 10), or neither to page through the full dataset. Unrecognized parameter names and values return 400.
query, enters TLD browse mode.false leaves out every country-code TLD, so only generic TLDs remain; true is the same as omitting it. Only the literals true / false.false leaves out every generic TLD, so only country-code TLDs remain; true is the same as omitting it. Only the literals true / false. Together with cctld=false, no rows are returned.start, end, middle. Requires query; omit to match anywhere.sedo,godaddy or 4.cn). Values follow the data; a platform with no listings returns an empty result, not an error.400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.listed_days_max=3 for fresh listings.true / false.length_asc (default) length_desc alpha tld_count_asc tld_count_desc.domain, tld, length, for_sale (listing code), platform (marketplace name), listed_days (1-3, null when older), tld_countExport full results as a downloadable file. Add export=csv or export=txt to any endpoint listed below, with any of that endpoint's filters. Export bypasses pagination and returns up to 50,000 results in a single response (per-endpoint caps below). All export requests, regardless of endpoint, use Export credits. Returns 404 when no rows match.
An export uses two kinds of credits: the credits the same request would use without export (Search credits per condition on the search endpoints, 1 credit on the other endpoints), plus 1 Export credit. If either kind is short, the request returns 429 and nothing is used.
csv or txt.
csv returns a per-endpoint column set, listed belowtxt returns domain names only, one per line/search/nrds: domain, tld, created, expires, period, length, tld_count, for_sale, live, nameservers/search/aged: domain, tld, created, age, length, for_sale, tld_count/search/expired: domain, tld, created, age, status, auction_date, found_date, length, category, majestic, backlinks, registrar_name, tld_count/search/deleted: domain, tld, age, reg_year, exp_year, found_date, length, hold, tld_count/search/active: domain, tld, length, for_sale, tld_count/search/market: domain, tld, length, for_sale, platform, listed_days, tld_count/ns-reverse: domain, tld, length/monitor/changes: domain, tld, found_date, reason, details_old, details_new, length, tld_count/typosquat: domain, tld, type, registered, for_sale, expiring, tld_countsort is omitted, each endpoint exports in its default order
(newest first on /search/nrds, oldest first on /search/aged,
/search/expired, and /search/deleted, shortest first on
/search/active, /search/market, and /ns-reverse,
most recent change first on /monitor/changes; /typosquat
exports in generation order, grouped by variant class).
/search/nrds, /search/aged, /search/active, /search/expired, /search/deleted, /search/market (up to 50,000 rows)/ns-reverse, /monitor/changes (up to 50,000 rows; columns in their sections)/typosquat (the whole generated set, up to 5,000 rows; no latest_whois in exports)/ct/subdomains (up to 10,000 rows), /ct/certs (5,000)| Plan | Per minute | Per day | Per month |
|---|---|---|---|
| Premium | 2 | 10 | 100 |
| Platinum | 10 | 100 | 1,000 |
/usage.Search hostnames by keyword across recently issued certificates. Returns the hostnames that received a certificate inside a time window of up to 24 hours (by default the last 6 hours), newest first, from the last 60 days. Each hostname appears once, at the time of its most recent certificate, so a hostname that received another certificate later is listed under the later time and not in earlier windows.
This endpoint has its own parameters and its own credits (Hostname credits). Any parameter not listed below, including sort, offset and export, returns 400.
tld for it.q is matched: reg (the registrable label only, paypal-secure in login.paypal-secure.com) or sub (the subdomain part only, login). Omit to match both. sld is accepted as an alias of sub. Any other value returns 400.YYYY-MM-DD (00:00 UTC that day), YYYY-MM-DDTHH:MM:SS (UTC), RFC 3339, today, yesterday, Nd (00:00 UTC, counting today as the first day, so 1d equals today) or Nh (N hours ago). Must fall within the last 60 days and not in the future.since, and must be later than it. The window spans at most 24 hours, so since=yesterday needs an until.com, co.uk).gtld or cctld, lowercase. Any other value returns 400.400. There is no paging: when total is larger than limit, split the window into shorter ones.total (hostnames that matched in the window, before limit), window (the since and until actually used, UTC). Each row: hostname (the full name as it appears on the certificate, which can start with *.), reg_domain (the registrable domain, equal to hostname when there is no subdomain), issuretime (when the hostname's most recent certificate was issued, UTC, to the second).hostname at the dots. Suffixes such as co.uk span more than one label.Retrieve WHOIS registration data for a domain name.
abtdomain.com). Internationalized domain names are accepted in Unicode (bĂĽcher.de) or punycode (xn--bcher-kva.de) form; responses use the punycode form.Query DNS records for a domain. The records object is keyed by record type (A, AAAA, MX, NS, TXT, CNAME, SOA, and CAA when present). A record type is included only when the resolver returns data for it; an absent key is not proof that no such record exists. Parse defensively.
google.com). Internationalized domain names are accepted in Unicode (bĂĽcher.de) or punycode (xn--bcher-kva.de) form; responses use the punycode form.Resolve nameservers for up to 20 domains in one request. Where the nameservers identify a marketplace or a parking service, the entry carries a domain_status of for_sale or parking; domains in normal use have no such field. Each domain in the batch uses 1 DNS credit, the same credits as /dns, so a batch of 20 costs the same as 20 single lookups. Batch calls are capped at 5 per minute.
Registrar, dates, EPP status codes and nameservers for up to 30 domains in one request. No registrant personal data is returned. Each domain in the batch uses 1 WHOIS credit, the same credits as /whois, so a batch of 30 costs the same as 30 single lookups. Batch calls are capped at 5 per minute.
resolved: false (query failed or the suffix is not queried) or supported: false (the TLD has no public lookup interface) and no registered key, so "not concluded" is never reported as "not registered".Find all domains using a specific nameserver, across gTLDs and ccTLDs (multi-level suffixes like co.uk supported). Same parameter vocabulary as the search endpoints; unrecognized parameter names and values return 400.
ns1.example.com). Up to 10 comma-separated nameservers return the domains that use all of them (an intersection), e.g. ns1.example.com,ns2.example.com; the other filters apply on top of it. This is the opposite of tld, where a comma list means any of them. An unknown nameserver returns an empty result, not an error; in a list, one unknown nameserver makes the whole result empty.com,net or co.uk).start, end, middle. Requires query; omit to match anywhere.true / false; 1, 0, yes return 400.length_asc (default) length_desc alpha.csv, txt. Bypasses pagination and returns up to 50,000 rows in one pass. Uses 1 Export credit on top of this endpoint's own credits; Export credits carry a monthly limit. txt is one domain per line; csv columns: domain, tld, length. Returns 404 when no rows match.ns (echo; for a list, the nameservers joined by commas), ns_total (domains on this nameserver, or on all of the listed nameservers, before filters), total (matches after filters), limit, offset. Each record: domain, tld, length.Look up geolocation and network information for an IP address or domain. Domains are resolved server-side (scheme and www. prefixes are stripped). Fields with no data are null (numbers) or empty strings. IP geolocation data by MaxMind (GeoLite2).
Search ICANN-accredited registrars by name substring (with alias support) or exact match by IANA ID. Results include accreditation status, RDAP URL, drop-catch platform detection, parent organization mapping, and RDAP contact details when available. total is the full hit count; page with limit / offset.
godaddy or 146).20.0.parent_id is an IANA ID or a platform label (not always numeric); empty when independent.false means RDAP contact details (address / phone / email) could not be fetched for this row, not that none exist.Look up EPP domain status codes. Search by status name, alias, or category (e.g. clientHold, pending, security). Each row is one status code; possible_reasons is always present and is an empty string when not applicable.
Generate lookalike domains for a domain and check which variants are registered. Fourteen classes: ASCII-fold (accent-dropped look-alikes of an internationalized name), omission, transposition, keyboard-adjacent replacement, insertion, repetition, hyphenation, vowel-swap, homoglyph, plural/singular, exact-TLD, TLD-swap, combosquatting (brand + keyword), and IDN homograph (Cyrillic look-alikes, returned as ASCII punycode xn-- domains). Registered variants carry a latest_whois snapshot. Use for brand protection, phishing detection, and defensive registration planning. Internationalized domains are accepted in Unicode (hellocafé.com) or punycode (xn--hellocaf-i1a.com) form; for those the ascii-fold class gives the accent-dropped look-alikes (hellocafe.com). Variants that are themselves internationalized come back as punycode with the Unicode form in unicode. Subdomains are reduced to their registrable domain (www.example.co.uk becomes example.co.uk).
example.com). Must include a TLD.omission,combosquatting). Omit for all 13. Any other value returns 400.true, who is squatting) or only unregistered (false, still available to register defensively) variants. Omit for both. Only the literals true / false.true. Set to false to skip WHOIS lookups entirely, returning only registration status. Speeds up the response. Not applied to export downloads.csv, txt. Uses 1 Export credit on top of this endpoint's own credits; Export credits carry a monthly limit. txt is one domain per line; csv columns are domain, tld, type, registered, for_sale, expiring, tld_count (exports do not carry latest_whois). Returns 404 when no rows match.types and registered filters, independent of offset.ascii-fold, omission, transposition, replacement, insertion, repetition, hyphenation, vowel-swap, homoglyph, plural, exact-tld, tld-swap, combosquatting, idn-homograph.0 for names nobody has registered.Check the registration status of a domain prefix across monitored TLDs.
abtdomain).count, check (default), or list.mode=check). Default: com,net,org,io,ai,bot,dev,app,pro,online.Track status changes of high-value domains over the last 7 days: transfers, drops, renewals, and nameserver updates. Each row is one change event, so a domain that changed twice appears twice. All parameters are optional; without filters, returns the most recent events first. Unrecognized parameter names and values return 400.
start, end, middle. Requires query; omit to match anywhere.new_registration, domain_transfer, domain_expired, nameserver_change.YYYY-MM-DD, inclusive. Data covers the last 7 days.true / false. No filter is applied by default.found_date_desc (default, most recent change first) found_date_asc length_asc length_desc tld_count_asc tld_count_desc alpha alpha_desc.csv, txt. Bypasses pagination. Uses 1 Export credit on top of this endpoint's own credits; Export credits carry a monthly limit. txt is one domain per line; csv columns match this endpoint's JSON fields. Returns 404 when no rows match.domain, tld, found_date, reason, details_old / details_new (state before / after the change: registrar or nameservers), length, tld_countDiscover subdomains observed in Certificate Transparency logs. Each row carries d, the label relative to the domain you queried (querying example.com returns mail, meaning mail.example.com), and ls, the date that name was last seen in a log. Covers certificates that are currently valid.
example.com).400.YYYY-MM-DD).YYYY-MM-DD).csv, txt. Bypasses pagination and returns up to 10,000 rows in one pass. Uses 1 Export credit on top of this endpoint's own credits; Export credits carry a monthly limit. The export expands each label into a full hostname, so it does not match the JSON field names: txt is one full hostname per line, and csv columns are domain (full hostname), subdomain (the bare label, same value as d) and last_seen.Look up certificate records by exact hostname, by registrable domain, or by SHA-256 fingerprint. Covers currently valid certificates. Use reg_domain to pull the root and every subdomain in one call instead of enumerating subdomains and querying each one.
www.example.com. One of domain, reg_domain, or fingerprint is required.example.com. Returns certificates for the root and all of its subdomains, one row per certificate (deduplicated by fingerprint, san_list carries every name the certificate covers). Combine with domain to run the exact lookup inside that root without deduplication.reg_domain and domain.domain, widen the lookup to that name and everything beneath it, deduplicated by fingerprint the same way reg_domain is. Use it when the root of the sweep is an arbitrary name rather than the registrable domain, for example include_subdomains=true with domain=eu.example.com. Cannot be combined with fingerprint, and the domain must have more than one label.400.R11, WE1).DV, OV, EV.YYYY-MM-DD or YYYY-MM-DD HH:MM:SS.after, and must not be earlier than it.csv, txt. Bypasses pagination and returns up to 5,000 rows in one pass. Uses 1 Export credit on top of this endpoint's own credits; Export credits carry a monthly limit. txt is one domain per line; csv columns match this endpoint's JSON fields.Download newly registered domains data files. Returns a 302 redirect to a signed download URL valid for 5 minutes. Each file can be downloaded up to 10 times per account in total, on every plan, the same as on the download page.
Available on every plan. The files and the days of history depend on your plan, the same as on the download page; a file or a date outside your plan returns 403, and a file that does not exist returns 404.
| Plan | Files | History |
|---|---|---|
| Free | domains_only | 3 days |
| Lite | domains_only | 15 days |
| Advanced | domains_only, basic_info | 15 days |
| Advanced Pass | domains_only, basic_info | latest daily file |
| Premium | domains_only, basic_info | 30 days |
| Platinum | all three types | all available files |
On every plan except Platinum, files for country-code TLDs outside NRDs Country Codes return 403. So does the all-TLD file (no tld) on a date whose data includes such TLDs; download each TLD separately instead.
domains_only.
domains_only (.txt.gz) domain names, one per line. e.g. abtdomain.combasic_info (.csv.gz) domain, registration date, expiration date. e.g. abtdomain.com,2026-06-30,2027-06-30full_whois (.csv.gz, Platinum only) domain, registration date, expiration date, registrar, status codes, nameservers. e.g. abtdomain.com,2026-06-30,2027-06-30,GoDaddy.com LLC,clientTransferProhibited,ns1.example.com|ns2.example.comYYYY-MM-DD format. Defaults to the latest daily file.View the credits you have used and have left, per endpoint.
Usage is counted in credits. Each endpoint has its own credits, with a per-minute and a daily limit that vary by tier; the credits of one endpoint are not used by another. A value of unlimited means no numeric cap applies. Daily credits reset at 00:00 UTC; per-minute limits use a rolling 60-second window. Export credits additionally carry a monthly limit, which resets on the 1st (UTC). When a limit is reached, the API returns 429 Too Many Requests.
How credits are used. Most requests use 1 credit. A search request uses 1 Search credit per condition: every parameter you send counts as one condition, including sort, limit, offset and position; a min/max or start/end pair counts as one; a request with no parameters uses 1. For example, a keyword alone uses 1, a keyword sorted by date uses 2, and a keyword sorted by date within a date range uses 3. Bulk lookups use 1 credit per domain. An export uses the credits of its endpoint plus 1 Export credit.
| Credits | Premium / min | Premium / day | Platinum / min | Platinum / day | Max results |
|---|---|---|---|---|---|
| Search credits | 60 | 2,000 | unlimited | unlimited | 50,000 |
| Hostname credits | 10 | 100 | 30 | unlimited | 500 |
| Export credits | 2 | 10 100 / month | 10 | 100 1,000 / month | 50,000 |
| WHOIS credits | 30 | 500 | 50 | unlimited | |
| DNS credits | 60 | 500 | unlimited | unlimited | |
| Reverse NS credits | 20 | 100 | unlimited | 500 | 1,000 |
| Domain Changes credits | 20 | 2,000 | unlimited | unlimited | 1,000 |
| TLD Check credits | 20 | 600 | unlimited | unlimited | |
| IP Lookup credits | 20 | 200 | 50 | unlimited | |
| Registrar credits | 20 | 200 | 50 | unlimited | |
| Status Guide credits | 30 | unlimited | unlimited | unlimited | |
| TLD Trends credits | 30 | unlimited | unlimited | unlimited | |
| Keyword Trends credits | 20 | unlimited | unlimited | unlimited | P:50 / Plat:100 |
| CT Subdomains credits | 10 | 200 | 20 | unlimited | 10,000 |
| CT Certs credits | 10 | 200 | 20 | unlimited | 5,000 |
| Typosquat credits | 1 | 20 | unlimited | unlimited | |
| NRDs Download (not counted in credits) | unlimited | unlimited | unlimited | unlimited | 10 per file |
| Usage credits | 30 | unlimited | 30 | unlimited |
Get daily registration volume trends for a gTLD. Only gTLDs are supported (ccTLDs are not available). Pass one TLD or compare up to 10 (comma-separated); rows are flat and each carries a tld field, so single- and multi-TLD requests share one response shape. TLDs with no data are reported in tlds_missing instead of being silently skipped.
com or com,net,org). One row per TLD per day.30. An out-of-range value returns 400.Get trending domain registration keywords. hot: top keywords by 28-day registrations. emerging: fastest growing keywords, with growth metrics (increase, surge, w1_avg, w4_avg) that are null on the hot board. prefix: trending domain prefixes with 30-day, 7-day and 48-hour registration counts.
all (default) or com (.com only). Only for hot and emerging; prefix rejects it with 400.The 147 country-code TLDs covered by /search/nrds, which are also the codes it accepts in tld and cctld. Any other country-code TLD there returns 400. On every plan except Platinum, NRDs Download offers files only for these country-code TLDs, and on Premium /search/active returns only these country-code TLDs.
com.br or my.id.af ar at aw ax be bf bh bi bj bm bn bo br bw ca ci cl cm cr cv cz dk dm do dz ec ee fi fj fr ga gd gg gh gi gs gy hk hn hr ht hu id ie il it je jo jp ke kg ki kn kr ky lb lc ls lt ma mc mg mk ml mn mr mw mx my mz ng nl no pg pk pl pm pn pw re ro rs rw sb sd se sg sk sm sn ss sx tc td tf tg th tl tn tw tz ua ug uk uz ve vi vu wf ye yt za zmexample.ai.ac ad ag ai am as bz cc co fm gl in io is la ly md me ms mu nu pr sc sh si so sr st to tv vc vg ws