DomainKits API

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.

Base URL
https://premium-api.domainkits.com/api/v1
Authentication

Include your API key in every request. API keys are the same keys used for the DomainKits MCP Server.

Authorization Header (recommended)
Authorization: Bearer dk_xxx
Custom Header
X-API-Key: dk_xxx
Quick Start
# Search newly registered .com domains curl "https://premium-api.domainkits.com/api/v1/search/nrds?tld=com" \ -H "Authorization: Bearer dk_your_key"
Response
{ "success": true, "data": [...], "total": 12345 }
Missing or Invalid Key
{ "success": false, "error": "API key required." }
Versioning

The API is versioned in the URL path (/api/v1). Customer-visible changes are listed in the Changelog.

Credit reset
Daily credits reset at 00:00 UTC. Per-minute credit limits use a rolling 60-second window. API credits are separate from the DomainKits web interface and the MCP server, which are metered independently.
Version in path
https://premium-api.domainkits.com/api/v1/...
Per-minute credit headers (every metered response)
X-RateLimit-Limit: 60 X-RateLimit-Remaining: 57 X-RateLimit-Reset: 1719744000
Forward compatibility
# New fields may appear over time. # Ignore unknown keys; never assume # the field set is closed within v1.
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.

2026-11-12
New
  • /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.
Changed
  • Action required. On Premium, /nrds/download covers the last 30 days, the same as the download page; an older date returns 403.
  • Action required. /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.
  • Action required. /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.
2026-11-11
Changed
  • Action required. Search requests use 1 Search credit per condition instead of 1 per request. 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. Applies to /search/nrds, /search/aged, /search/active, /search/expired, /search/deleted and /search/market.
  • Action required. Search returns at most 100 results per page (was 500). A larger limit returns 100 rows; use offset to read further. Applies to the same six search endpoints.
  • Action required. An export now also uses the credits of the endpoint it runs on, in addition to 1 Export credit: Search credits per condition on the six search endpoints, and 1 credit on /ns-reverse, /monitor/changes, /typosquat, /ct/subdomains and /ct/certs. If either kind is short, the request returns 429 and nothing is used.
  • Usage limits are now described in credits, and each endpoint has its own named credits, listed under Credits. The numbers are unchanged.
v0.4.3 (2026-10-25)
Removed
  • /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.
New
  • /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.
v0.4.2 (2026-10-13)
Removed
  • /search/nrds-live has been removed. Remove calls to it from your integration.
Changed
  • /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.
v0.4.1 (2026-10-03)
New
  • /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.
Removed
  • The trial tier. Access and credits follow your plan (Premium or Platinum), and 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.
Changed
  • /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.
2026-10-02
Removed
  • /ct/search has been removed. Remove calls to it from your integration.
2026-09-28
Removed
  • /safety has been removed. Remove calls to it from your integration.
New
  • /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.
Changed
  • /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.
v0.3.11 (2026-09-14)
Action required
  • /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.
New
  • /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.
Changed
  • /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".
v0.3.10 (2026-09-03)
Action required
  • /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.
New
  • /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.
  • Error responses carry request_id. A 429 carries Retry-After.
Changed
  • CT date parameters accept YYYY-MM-DD HH:MM:SS as well as YYYY-MM-DD.
  • CT exports are capped at 500 rows. A truncated export carries the header X-CT-Complete: false, because the file itself looks identical to a complete one.
  • A CT export that could not be completed returns 503 instead of 404. The old 404 reported "no results" for a search that had not finished.
2026-09-28 · /ns-reverse, shared nameservers
curl "https://premium-api.domainkits.com/api/v1/ns-reverse?ns=ns1.example.com,ns2.example.com" \ -H "Authorization: Bearer dk_xxx" # domains that use both nameservers
v0.3.11 · /bulk/whois, inconclusive entry
// before { "domain": "example.com", "registered": false } // after: no registered key { "domain": "example.com", "resolved": false }
Reading it safely
# true only when the lookup # actually reached a conclusion available = row.get("registered") is False
v0.3.11 · registrar_name
// before "Cloudflare" // after "Cloudflare, Inc."
v0.3.11 · IDN input
curl "https://premium-api.domainkits.com/api/v1/typosquat?domain=hellocaf%C3%A9.com" \ -H "Authorization: Bearer dk_xxx" # ascii-fold -> hellocafe.com
Errors

The API uses standard HTTP status codes. Errors return a JSON object with success: false and an error message.

200 Success
302 Redirect (file download)
400 Bad request
401 Unauthorized
403 Forbidden
405 Method not allowed
429 Credit limit reached
502 Request timed out
Error Response
{ "success": false, "error": "Error message here" }
GET /api/v1/search/nrds

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.

Query Parameters
query stringoptional
Search keyword matched as a substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10 (e.g. com or com,net,org). Results are the union. Without query, enters TLD browse mode.
cctld stringoptional
Keep only these country-code TLDs, as comma-separated two-letter codes (e.g. 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.
gtld booleanoptional
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.
position stringoptional
Keyword position within the second-level label. Values: start, end, middle. Requires query; omit to match anywhere.
length_min / length_max integeroptional
Second-level label length range, 1-63. Either side may be omitted; equal values select an exact length.
period_min / period_max integeroptional
Registration term range in years, 1-10.
tld_count_min / tld_count_max integeroptional
Range for how many TLDs the second-level label is registered under, 1-10000. Either side may be omitted; equal values select an exact count. A min greater than the max returns 400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.
create_date_start / create_date_end dateoptional
Registration date range, YYYY-MM-DD, inclusive. Either side may be omitted.
has_number / all_number / all_alpha / has_hyphen / has_sale booleanoptional
Composition and listing filters. Only the literals true / false; 1, 0, yes return 400. has_sale=true keeps only domains with a marketplace listing.
exclude_query stringoptional
Negative keywords, comma-separated; matching domains are excluded.
ns stringoptional
Keep only domains that use this nameserver. A domain such as 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.
exclude_ns stringoptional
Leave out domains that use any of these nameservers, comma-separated, up to 10; each value follows the 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.
live booleanoptional
Whether the freshest rows are included. 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.
sort stringoptional
reg_date_desc (default) reg_date_asc length_asc length_desc period_asc period_desc tld_count_asc tld_count_desc alpha.
limit integeroptional
Results per page (default: 40, max: 100). A larger value returns 100 rows.
offset integeroptional
Pagination offset, 0-200,000. Beyond that use export.
Response fields
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.
Request (keyword search)
curl "https://premium-api.domainkits.com/api/v1/search/nrds?query=tech&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 99114, "limit": 2, "offset": 0, "data": [ { "domain": "wellcelltech.com", "tld": "com", "created": "2026-08-11", "expires": "2027-08-11", "period": 1, "length": 12, "tld_count": 1, "for_sale": "", "live": false, "nameservers": "dns1.registrar-servers.com;dns2.registrar-servers.com" } ] }
Request (TLD browse, short names without hyphens)
curl "https://premium-api.domainkits.com/api/v1/search/nrds?tld=com&length_max=4&has_hyphen=false&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 1137337, "limit": 2, "offset": 0, "data": [ { "domain": "rvkp.com", "tld": "com", "created": "2026-08-10", "expires": "2027-08-10", "period": 1, "length": 4, "tld_count": 1, "for_sale": "", "live": false, "nameservers": "kate.ns.cloudflare.com;rick.ns.cloudflare.com" } ] }
GET /api/v1/search/aged

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 Parameters
query stringoptional
Search keyword matched as a substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10. Without query, enters TLD browse mode.
position stringoptional
Values: start, end, middle. Requires query; omit to match anywhere.
length_min / length_max integeroptional
Second-level label length range, 1-63.
age_min / age_max integeroptional
Domain age range in years, 0-100. Either side may be omitted.
tld_count_min / tld_count_max integeroptional
Range for how many TLDs the second-level label is registered under, 1-10000. Either side may be omitted; equal values select an exact count. A min greater than the max returns 400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.
has_number / all_number / all_alpha / has_hyphen / has_sale booleanoptional
Composition and listing filters. Only the literals true / false.
exclude_query stringoptional
Negative keywords, comma-separated.
sort stringoptional
age_desc (default) age_asc length_asc length_desc reg_date_asc reg_date_desc tld_count_asc tld_count_desc.
limit integeroptional
Results per page (default: 40, max: 100). A larger value returns 100 rows.
offset integeroptional
Pagination offset, 0-200,000.
Response fields
domain, tld, created (full date), age (years), length, for_sale (listing code, empty when not listed), tld_count
Request (keyword search)
curl "https://premium-api.domainkits.com/api/v1/search/aged?query=tech&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 554550, "limit": 2, "offset": 0, "data": [ { "domain": "bostech.com", "tld": "com", "created": "1988-03-12", "age": 38, "length": 7, "for_sale": "", "tld_count": 26 } ] }
Request (TLD browse, 20+ years, short names)
curl "https://premium-api.domainkits.com/api/v1/search/aged?tld=com&age_min=20&length_max=4&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 346696, "limit": 2, "offset": 0, "data": [ { "domain": "bbn.com", "tld": "com", "created": "1985-04-24", "age": 41, "length": 3, "for_sale": "", "tld_count": 119 } ] }
GET /api/v1/search/active

Search 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 Parameters
query stringoptional
Search keyword matched as a substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10. Without query, enters TLD browse mode.
cctld stringoptional
Keep only these country-code TLDs, as comma-separated two-letter codes (e.g. 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.
gtld booleanoptional
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.
position stringoptional
Values: start, end, middle. Requires query; omit to match anywhere.
length_min / length_max integeroptional
Second-level label length range, 1-63.
has_number / all_number / all_alpha / has_hyphen / has_sale booleanoptional
Composition and listing filters. Only the literals true / false.
tld_count_min / tld_count_max integeroptional
Range for how many TLDs the second-level label is registered under, 1-10000. Either side may be omitted; equal values select an exact count. A min greater than the max returns 400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.
exclude_query stringoptional
Negative keywords, comma-separated.
sort stringoptional
length_asc (default) length_desc alpha tld_count_asc tld_count_desc.
limit integeroptional
Results per page (default: 40, max: 100). A larger value returns 100 rows.
offset integeroptional
Pagination offset, 0-200,000.
Response fields
domain, tld, length, for_sale (listing code, empty when not listed), tld_count
Request
curl "https://premium-api.domainkits.com/api/v1/search/active?query=tech&limit=2" \ -H "Authorization: Bearer dk_xxx"
Request (TLD browse, listed for sale only)
curl "https://premium-api.domainkits.com/api/v1/search/active?tld=com&has_sale=true&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 265881, "limit": 2, "offset": 0, "data": [ { "domain": "tech.asia", "tld": "asia", "length": 4, "for_sale": "se", "tld_count": 488 } ] }
GET /api/v1/search/expired

Search 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 Parameters
query stringoptional
Search keyword matched as a substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10. Without query, enters TLD browse mode.
position stringoptional
Values: start, end, middle. Requires query; omit to match anywhere.
length_min / length_max integeroptional
Second-level label length range, 1-63.
age_min / age_max integeroptional
Domain age range in years, 0-100.
tld_count_min / tld_count_max integeroptional
Range for how many TLDs the second-level label is registered under, 1-10000. Either side may be omitted; equal values select an exact count. A min greater than the max returns 400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.
status stringoptional
Expiry stage filter. Values: expired, redemption, pending_delete.
registrar_name stringoptional
Part of the registrar name, case-insensitive: 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.
auction_date_start / auction_date_end dateoptional
Auction date range, YYYY-MM-DD, inclusive. Either side may be omitted.
found_date_start / found_date_end dateoptional
Range for the date the domain was first observed in the expired pool, YYYY-MM-DD, inclusive. Use a recent start date to select fresh expiries.
has_number / all_number / all_alpha / has_hyphen booleanoptional
Composition filters. Only the literals true / false.
exclude_query stringoptional
Negative keywords, comma-separated.
sort stringoptional
age_desc (default) age_asc length_asc length_desc tld_count_asc tld_count_desc.
limit integeroptional
Results per page (default: 40, max: 100). A larger value returns 100 rows.
offset integeroptional
Pagination offset, 0-200,000.
Response fields
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.
Request (keyword search)
curl "https://premium-api.domainkits.com/api/v1/search/expired?query=tech&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 67035, "limit": 2, "offset": 0, "data": [ { "domain": "timestech.com", "tld": "com", "created": "1994-05-02", "age": 32, "status": "expired", "auction_date": "", "found_date": "2026-08-05", "length": 9, "category": "", "majestic": null, "backlinks": null, "registrar_name": "", "tld_count": 9 } ] }
Request (TLD browse, pending delete)
curl "https://premium-api.domainkits.com/api/v1/search/expired?tld=com&status=pending_delete&limit=2" \ -H "Authorization: Bearer dk_xxx"
GET /api/v1/search/deleted

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 Parameters
query stringoptional
Search keyword matched as a substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10. Without query, enters TLD browse mode.
position stringoptional
Values: start, end, middle. Requires query; omit to match anywhere.
length_min / length_max integeroptional
Second-level label length range, 1-63.
age_min / age_max integeroptional
Domain age range in years, 0-100.
tld_count_min / tld_count_max integeroptional
Range for how many TLDs the second-level label is registered under, 1-10000. Either side may be omitted; equal values select an exact count. A min greater than the max returns 400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.
has_hold booleanoptional
Registrar hold status. Only true / false.
found_date_start / found_date_end dateoptional
Range for the date the drop was observed, YYYY-MM-DD, inclusive. Use a recent start date to select fresh drops.
has_number / all_number / all_alpha / has_hyphen booleanoptional
Composition filters. Only the literals true / false.
exclude_query stringoptional
Negative keywords, comma-separated.
sort stringoptional
age_desc (default) age_asc length_asc length_desc tld_count_asc tld_count_desc.
limit integeroptional
Results per page (default: 40, max: 100). A larger value returns 100 rows.
offset integeroptional
Pagination offset, 0-200,000.
Response fields
domain, tld, age (years), reg_year, exp_year (year granularity), found_date, length, hold, tld_count
Request
curl "https://premium-api.domainkits.com/api/v1/search/deleted?query=tech&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 167989, "limit": 2, "offset": 0, "data": [ { "domain": "aristechchem.com", "tld": "com", "age": 29, "reg_year": "1997", "exp_year": "2026", "found_date": "2026-06-04", "length": 12, "hold": "", "tld_count": 1 } ] }
GET /api/v1/search/market

Search 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 Parameters
query stringoptional
Search keyword matched as a substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10. Without query, enters TLD browse mode.
cctld booleanoptional
false leaves out every country-code TLD, so only generic TLDs remain; true is the same as omitting it. Only the literals true / false.
gtld booleanoptional
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.
position stringoptional
Values: start, end, middle. Requires query; omit to match anywhere.
length_min / length_max integeroptional
Second-level label length range, 1-63.
platform stringoptional
Marketplace the listing appears on, comma-separated, up to 10, case-insensitive (e.g. sedo,godaddy or 4.cn). Values follow the data; a platform with no listings returns an empty result, not an error.
tld_count_min / tld_count_max integeroptional
Range for how many TLDs the second-level label is registered under, 1-10000. Either side may be omitted; equal values select an exact count. A min greater than the max returns 400. The count is a snapshot taken when the dataset was loaded, not a live lookup. Also applies to export.
listed_days_min / listed_days_max integeroptional
Days since the listing first appeared, 1-3 (1 = today). Listings older than 3 days count as 4+ for this range; use listed_days_max=3 for fresh listings.
has_number / all_number / all_alpha / has_hyphen / has_sale booleanoptional
Composition and listing filters. Only the literals true / false.
exclude_query stringoptional
Negative keywords, comma-separated.
sort stringoptional
length_asc (default) length_desc alpha tld_count_asc tld_count_desc.
limit integeroptional
Results per page (default: 40, max: 100). A larger value returns 100 rows.
offset integeroptional
Pagination offset, 0-200,000.
Response fields
domain, tld, length, for_sale (listing code), platform (marketplace name), listed_days (1-3, null when older), tld_count
Request (keyword search)
curl "https://premium-api.domainkits.com/api/v1/search/market?query=tech&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 22841, "limit": 2, "offset": 0, "data": [ { "domain": "tech.exchange", "tld": "exchange", "length": 4, "for_sale": "go", "platform": "Godaddy", "listed_days": null, "tld_count": 521 } ] }
Request (TLD browse, one marketplace)
curl "https://premium-api.domainkits.com/api/v1/search/market?tld=com&platform=sedo&limit=2" \ -H "Authorization: Bearer dk_xxx"
Search Export

Export 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.

Export Parameter
export stringoptional
Export format. Values: csv or txt.
  • csv returns a per-endpoint column set, listed below
  • txt returns domain names only, one per line
CSV Columns
CSV columns match each endpoint's JSON response fields exactly.
  • /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_count
When sort 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).
Supported Endpoints
  • /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)
Export Credits
Each export uses 1 Export credit, on top of the credits of the endpoint it runs on.
PlanPer minutePer dayPer month
Premium210100
Platinum101001,000
Daily credits reset at 00:00 UTC; monthly credits reset on the 1st (UTC). Credits follow the account, so regenerating an API key does not reset them. Track what you have left with /usage.
Request (CSV export)
curl -o results.csv \ "https://premium-api.domainkits.com/api/v1/search/nrds?query=tech&has_number=false&export=csv" \ -H "Authorization: Bearer dk_xxx"
CSV Response
domain,tld,created,expires,period,length,tld_count,for_sale,live,nameservers wellcelltech.com,com,2026-08-11,2027-08-11,1,12,1,,false,dns1.registrar-servers.com;dns2.registrar-servers.com biotechlab.net,net,2026-08-10,2027-08-10,1,10,3,se,false,kate.ns.cloudflare.com;rick.ns.cloudflare.com ...
Request (TXT export)
curl -o results.txt \ "https://premium-api.domainkits.com/api/v1/search/nrds?query=tech&has_number=false&export=txt" \ -H "Authorization: Bearer dk_xxx"
TXT Response
wellcelltech.com biotechlab.net ...
Request (expired domains, CSV export)
curl -o expiring.csv \ "https://premium-api.domainkits.com/api/v1/search/expired?tld=com&status=pending_delete&export=csv" \ -H "Authorization: Bearer dk_xxx"
Request (TLD browse export, listed for sale)
curl -o com_forsale.txt \ "https://premium-api.domainkits.com/api/v1/search/active?tld=com&has_sale=true&export=txt" \ -H "Authorization: Bearer dk_xxx"
GET /api/v1/search/hostname

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.

Query Parameters
q stringrequired
Keyword, 3 to 64 characters, matched as a literal substring, not case-sensitive. The public suffix is not searched; use tld for it.
field stringoptional
Where 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.
since stringoptional
Window start, inclusive (default: 6 hours ago). Accepts 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.
until stringoptional
Window end, exclusive (default: now). Same formats as since, and must be later than it. The window spans at most 24 hours, so since=yesterday needs an until.
tld stringoptional
One public suffix, exact match (e.g. com, co.uk).
tld_type stringoptional
gtld or cctld, lowercase. Any other value returns 400.
limit integeroptional
Rows to return, 1 to 500 (default: 100). A value outside that range returns 400. There is no paging: when total is larger than limit, split the window into shorter ones.
Response fields
Envelope: 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).
Notes
Use reg_domain as given
Do not derive it by splitting hostname at the dots. Suffixes such as co.uk span more than one label.
Credits
Each request uses 1 Hostname credit. Premium: 10 per minute, 100 per day. Platinum: 30 per minute, no daily cap. Hostname credits are separate from Search credits.
503
Hostname search is temporarily unavailable. Retry after a short wait.
Request (last 6 hours, .com only)
curl "https://premium-api.domainkits.com/api/v1/search/hostname?q=example&tld=com&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 214, "window": { "since": "2026-10-03T06:04:17Z", "until": "2026-10-03T12:04:17Z" }, "data": [ { "hostname": "shop.example-store.com", "reg_domain": "example-store.com", "issuretime": "2026-10-03T12:01:52Z" }, { "hostname": "example-labs.com", "reg_domain": "example-labs.com", "issuretime": "2026-10-03T11:58:31Z" } ] }
Request (subdomain match, gTLDs, one full day)
curl "https://premium-api.domainkits.com/api/v1/search/hostname?q=login&field=sub&tld_type=gtld&since=2026-10-02&until=2026-10-03" \ -H "Authorization: Bearer dk_xxx"
Window too wide
{ "success": false, "error": "window too wide: 30.0 hours requested, max 24" }
GET /api/v1/whois

Retrieve WHOIS registration data for a domain name.

Query Parameters
domain stringrequired
Full domain name including TLD (e.g. abtdomain.com). Internationalized domain names are accepted in Unicode (bĂĽcher.de) or punycode (xn--bcher-kva.de) form; responses use the punycode form.
Request
curl "https://premium-api.domainkits.com/api/v1/whois?domain=abtdomain.com" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "registered": true, "data": { "domain": "abtdomain.com", "registrar_name": "NameSilo", "created": "2023-04-21T15:51:41Z", "expires": "2027-04-21T15:51:41Z", "updated": "2026-04-22T08:30:19Z", "nameservers": ["marvin.ns.cloudflare.com", "norah.ns.cloudflare.com"], "status": ["client transfer prohibited"] } }
GET /api/v1/dns

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.

Query Parameters
domain stringrequired
Domain name to query (e.g. google.com). Internationalized domain names are accepted in Unicode (bĂĽcher.de) or punycode (xn--bcher-kva.de) form; responses use the punycode form.
Request
curl "https://premium-api.domainkits.com/api/v1/dns?domain=google.com" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "data": { "domain": "google.com", "records": { "A": [{ "ip": "142.251.210.46", "ttl": 300 }], "AAAA": [{ "ipv6": "2607:f8b0:4006:811::200e", "ttl": 300 }], "MX": [{ "target": "smtp.google.com", "pri": 10 }], "NS": [{ "target": "ns1.google.com" }, ...] } } }
POST /api/v1/bulk/dns

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.

Body Parameters
domains arrayrequired
Domain names to resolve. Maximum 20 per request. Duplicates and malformed entries are dropped before the lookup. Internationalized domain names are accepted in Unicode or punycode form and are normalized to punycode in responses.
Request
curl -X POST "https://premium-api.domainkits.com/api/v1/bulk/dns" \ -H "Authorization: Bearer dk_xxx" \ -H "Content-Type: application/json" \ -d '{"domains": ["example.com", "example.net"]}'
Response
{ "success": true, "total": 2, "registered": 2, "data": [ { "domain": "example.com", "status": "registered", "nameservers": ["a.iana-servers.net", "b.iana-servers.net"] }, { "domain": "example.net", "status": "registered", "nameservers": ["ns1.sedoparking.com"], "domain_status": "parking" } ] }
POST /api/v1/bulk/whois

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.

Body Parameters
domains arrayrequired
Domain names to look up. Maximum 30 per request. Duplicates and malformed entries are dropped before the lookup. Internationalized domain names are accepted in Unicode or punycode form and are normalized to punycode in responses. An entry whose lookup did not reach a conclusion carries 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".
Request
curl -X POST "https://premium-api.domainkits.com/api/v1/bulk/whois" \ -H "Authorization: Bearer dk_xxx" \ -H "Content-Type: application/json" \ -d '{"domains": ["example.com", "example.net"]}'
Response
{ "success": true, "total": 2, "registered": 2, "data": [ { "domain": "example.com", "registered": true, "registrar_name": "RESERVED-IANA", "created": "1995-08-14T04:00:00Z", "expires": "2027-08-13T04:00:00Z", "status": ["client transfer prohibited"], "nameservers": ["a.iana-servers.net"] }, { "domain": "example.net", "registered": false } ] }
GET /api/v1/ns-reverse

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.

Query Parameters
ns stringrequired
Nameserver hostname (e.g. 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.
query stringoptional
Filter by substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10 (e.g. com,net or co.uk).
position stringoptional
Values: start, end, middle. Requires query; omit to match anywhere.
length_min / length_max integeroptional
Second-level label length range, 1-63.
has_number / all_number / all_alpha / has_hyphen booleanoptional
Composition filters. Only the literals true / false; 1, 0, yes return 400.
exclude_query stringoptional
Negative keywords, comma-separated.
sort stringoptional
length_asc (default) length_desc alpha.
limit integeroptional
Results per page (default: 40, max: 500).
offset integeroptional
Pagination offset, 0-200,000.
export stringoptional
Download results as a file instead of JSON. Values: 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.
Response fields
Envelope: 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.
Request
curl "https://premium-api.domainkits.com/api/v1/ns-reverse?ns=dns1.registrar-servers.com&length_max=6&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "ns": "dns1.registrar-servers.com", "ns_total": 1284512, "total": 48211, "limit": 2, "offset": 0, "data": [ { "domain": "ab.com", "tld": "com", "length": 2 } ] }
Response (unknown nameserver)
{ "success": true, "ns": "ns1.nobody.example", "ns_total": 0, "total": 0, "data": [] }
Request (domains using both nameservers)
curl "https://premium-api.domainkits.com/api/v1/ns-reverse?ns=ns1.example.com,ns2.example.com" \ -H "Authorization: Bearer dk_xxx"
GET /api/v1/ip-lookup

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).

Query Parameters
query stringrequired
IP address (IPv4 or IPv6) or domain name to look up.
Request
curl "https://premium-api.domainkits.com/api/v1/ip-lookup?query=8.8.8.8" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 1, "data": [ { "ip": "8.8.8.8", "type": "IPv4", "asn": 15169, "as_organization": "GOOGLE", "continent": "North America", "continent_code": "NA", "country": "United States", "country_code": "US", "is_eu": false, "region": "California", "region_code": "CA", "city": "Los Angeles", "postal": "90009", "latitude": 34.0544, "longitude": -118.2441, "timezone": "America/Los_Angeles" } ], "elapsed": "2ms" }
Request (domain)
curl "https://premium-api.domainkits.com/api/v1/ip-lookup?query=google.com" \ -H "Authorization: Bearer dk_xxx"
GET /api/v1/registrar

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.

Query Parameters
query stringrequired
Registrar name or IANA ID to search for (e.g. godaddy or 146).
limit integer
Rows per page. Default 20.
offset integer
Rows to skip. Default 0.
Response Fields
is_drop_catch
Whether the registrar belongs to a drop-catch / backorder platform.
parent_id / parent_name
Parent organization when the registrar is part of a group. parent_id is an IANA ID or a platform label (not always numeric); empty when independent.
rdap_fetched
false means RDAP contact details (address / phone / email) could not be fetched for this row, not that none exist.
Request (by name)
curl "https://premium-api.domainkits.com/api/v1/registrar?query=godaddy" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 1, "limit": 20, "offset": 0, "data": [ { "id": "146", "name": "GoDaddy.com, LLC", "status": "Accredited", "rdap_url": "https://rdap.godaddy.com/v1/", "is_drop_catch": false, "parent_id": "", "parent_name": "", "country": "United States of America", "contact": "Legal Department +1 4805058800 legal@godaddy.com", "website": "http://www.godaddy.com", "address": "2155 E GoDaddy Way, Tempe, AZ 85284, US", "phone": "tel:480 505 8865", "email": "generalcounsel@godaddy.com", "rdap_fetched": true } ], "elapsed": "3ms" }
Request (by IANA ID)
curl "https://premium-api.domainkits.com/api/v1/registrar?query=146" \ -H "Authorization: Bearer dk_xxx"
GET /api/v1/status-guide

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.

Query Parameters
query stringrequired
Status code, keyword, or category to search for.
Request
curl "https://premium-api.domainkits.com/api/v1/status-guide?query=clientHold" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 1, "data": [ { "status": "clientHold", "aliases": ["client hold", "clienthold"], "category": "Domain Not Working", "description": "Domain is on hold and will not resolve.", "action": "Contact your registrar immediately.", "severity": "critical", "possible_reasons": "Unpaid bills, suspected fraud..." } ], "elapsed": "1ms" }
Request (by category)
curl "https://premium-api.domainkits.com/api/v1/status-guide?query=security" \ -H "Authorization: Bearer dk_xxx"
GET /api/v1/typosquat

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).

Query Parameters
domain stringrequired
Domain to scan (e.g. example.com). Must include a TLD.
types stringoptional
Restrict generation to these variant classes, comma-separated (e.g. omission,combosquatting). Omit for all 13. Any other value returns 400.
registered booleanoptional
Keep only registered (true, who is squatting) or only unregistered (false, still available to register defensively) variants. Omit for both. Only the literals true / false.
whois booleanoptional
Default true. Set to false to skip WHOIS lookups entirely, returning only registration status. Speeds up the response. Not applied to export downloads.
limit integeroptional
Maximum variants to return, 1-5000. Defaults to the entire generated set: this endpoint's result set is bounded by construction (a few thousand rows at most), so there is nothing to page through by default.
offset integeroptional
Pagination offset, 0-5000.
export stringoptional
Download results as a file instead of JSON. Values: 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.
Response Fields
total integer
Matches after the types and registered filters, independent of offset.
generated / registered_total integer
Counts before filters: how many variants exist and how many are already taken. Together they answer "N lookalikes, M are registered" without a second request.
data[].type string
Variant class: ascii-fold, omission, transposition, replacement, insertion, repetition, hyphenation, vowel-swap, homoglyph, plural, exact-tld, tld-swap, combosquatting, idn-homograph.
data[].registered / for_sale / expiring mixed
Whether the variant is taken, its marketplace listing code (empty string when not listed), and whether it is in an expiring state.
data[].tld_count integer
How many TLDs this variant's name portion is registered under. 0 for names nobody has registered.
data[].latest_whois object
Most recent cached WHOIS snapshot for a registered variant, when available. Not a real-time lookup. Omitted when no snapshot exists.
Request (who is squatting)
curl "https://premium-api.domainkits.com/api/v1/typosquat?domain=example.com&registered=true" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "domain": "example.com", "total": 87, "generated": 449, "registered_total": 87, "limit": 5000, "offset": 0, "whois_note": "latest_whois reflects the most recent cached snapshot, not a real-time lookup", "data": [ { "domain": "exampl.com", "tld": "com", "type": "omission", "registered": true, "for_sale": "se", "expiring": false, "tld_count": 14, "latest_whois": { "created": "2019-03-12T00:00:00Z", "updated": "2025-07-16T00:00:00Z", "expires": "2026-03-12T00:00:00Z", "registrar_name": "Sav.com, LLC", "status": ["client transfer prohibited"], "nameservers": ["ns1.dan.com", "ns2.dan.com"] } } ] }
Request (still available, defensive registration)
curl "https://premium-api.domainkits.com/api/v1/typosquat?domain=example.com&registered=false&whois=false" \ -H "Authorization: Bearer dk_xxx"
Request (one class only, as a file)
curl "https://premium-api.domainkits.com/api/v1/typosquat?domain=example.com&types=combosquatting&export=csv" \ -H "Authorization: Bearer dk_xxx" -OJ
GET /api/v1/tld-check

Check the registration status of a domain prefix across monitored TLDs.

Query Parameters
prefix stringrequired
Domain prefix to check (e.g. abtdomain).
mode stringoptional
Response mode: count, check (default), or list.
tlds stringoptional
Comma-separated TLDs to check (only for mode=check). Default: com,net,org,io,ai,bot,dev,app,pro,online.
Request (check, default)
curl "https://premium-api.domainkits.com/api/v1/tld-check?prefix=abtdomain" \ -H "Authorization: Bearer dk_xxx"
Response (check)
{ "success": true, "data": { "com": "registered", "net": "available", "org": "available", "io": "available", "ai": "available" }, "total": 1, "prefix": "abtdomain" }
Request (count)
curl "https://premium-api.domainkits.com/api/v1/tld-check?prefix=abtdomain&mode=count" \ -H "Authorization: Bearer dk_xxx"
Response (count)
{ "success": true, "data": null, "total": 1, "prefix": "abtdomain" }
Request (list)
curl "https://premium-api.domainkits.com/api/v1/tld-check?prefix=google&mode=list" \ -H "Authorization: Bearer dk_xxx"
Response (list)
{ "success": true, "data": ["com", "net", "org", "io", ...], "total": 482, "prefix": "google" }
GET /api/v1/monitor/changes

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.

Query Parameters
query stringoptional
Search keyword matched as a substring of the second-level label (min 2 characters, letters/digits/hyphens).
tld stringoptional
TLD filter, comma-separated, up to 10.
position stringoptional
Values: start, end, middle. Requires query; omit to match anywhere.
reason stringoptional
Filter by change reason. Values: new_registration, domain_transfer, domain_expired, nameserver_change.
length_min / length_max integeroptional
Second-level label length range, 1-63.
found_date_start / found_date_end dateoptional
Range for the date the change was observed, YYYY-MM-DD, inclusive. Data covers the last 7 days.
has_number / all_number / all_alpha / has_hyphen booleanoptional
Composition filters. Only the literals true / false. No filter is applied by default.
exclude_query stringoptional
Negative keywords, comma-separated.
sort stringoptional
found_date_desc (default, most recent change first) found_date_asc length_asc length_desc tld_count_asc tld_count_desc alpha alpha_desc.
limit integeroptional
Results per page (default: 40, max: 500).
offset integeroptional
Pagination offset, 0-200,000.
export stringoptional
Download results as a file instead of JSON. Values: 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.
Response fields
domain, tld, found_date, reason, details_old / details_new (state before / after the change: registrar or nameservers), length, tld_count
Request
curl "https://premium-api.domainkits.com/api/v1/monitor/changes?query=premium&reason=nameserver_change&limit=3" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "total": 3, "limit": 3, "offset": 0, "data": [ { "domain": "challengepremium.com", "tld": "com", "found_date": "2026-06-26", "reason": "nameserver_change", "details_old": "NS59.DOMAINCONTROL.COM,NS60.DOMAINCONTROL.COM", "details_new": "", "length": 16, "tld_count": 1 } ] }
GET /api/v1/ct/subdomains

Discover 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.

Query Parameters
domain stringrequired
Registered domain to query (e.g. example.com).
limit integeroptional
Max results (default: 1000, max: 10000). A larger value returns 400.
after stringoptional
Only include records logged on or after this date (YYYY-MM-DD).
before stringoptional
Only include records logged on or before this date (YYYY-MM-DD).
export stringoptional
Download results as a file instead of JSON. Values: 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.
Request
curl "https://premium-api.domainkits.com/api/v1/ct/subdomains?domain=example.com&limit=5" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "data": [ { "d": "mail", "ls": "2026-07-20" }, { "d": "api", "ls": "2026-07-18" }, { "d": "cdn", "ls": "2026-06-01" } ], "total": 5 }
GET /api/v1/ct/certs

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.

Query Parameters
domain stringrequired*
Exact hostname to query, for example www.example.com. One of domain, reg_domain, or fingerprint is required.
reg_domain stringrequired*
Registrable domain, for example 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.
fingerprint stringrequired*
SHA-256 certificate fingerprint (64 hex chars). Takes precedence over reg_domain and domain.
include_subdomains booleanoptional
With 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.
limit integeroptional
Max results (default: 100, max: 5000). A larger value returns 400.
issuer stringoptional
Filter by certificate issuer (e.g. R11, WE1).
cert_type stringoptional
Filter by certificate type: DV, OV, EV.
after stringoptional
Records logged at or after this point, inclusive. Accepts YYYY-MM-DD or YYYY-MM-DD HH:MM:SS.
before stringoptional
Records logged at or before this point, inclusive. Same accepted formats as after, and must not be earlier than it.
export stringoptional
Download results as a file instead of JSON. Values: 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.
Request (whole registrable domain)
curl "https://premium-api.domainkits.com/api/v1/ct/certs?reg_domain=example.com&limit=2" \ -H "Authorization: Bearer dk_xxx"
Request (one exact hostname)
curl "https://premium-api.domainkits.com/api/v1/ct/certs?domain=www.example.com&limit=2" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "data": [ { "domain": "example.com", "log_time": "2026-07-20T16:18:16Z", "issue_time": "2026-07-20T16:08:14Z", "not_after": "2026-10-18T16:14:46Z", "issuer": "R11", "cert_type": "DV", "fingerprint": "73444a55...", "san_list": "*.example.com|example.com", "source": "google_argon2026h2", "reg_domain": "example.com" } ], "total": 2 }
GET /api/v1/nrds/download

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.

PlanFilesHistory
Freedomains_only3 days
Litedomains_only15 days
Advanceddomains_only, basic_info15 days
Advanced Passdomains_only, basic_infolatest daily file
Premiumdomains_only, basic_info30 days
Platinumall three typesall 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.

Query Parameters
tld stringoptional
TLD to download. Defaults to all TLDs combined.
type stringoptional
File type. Defaults to domains_only.
  • domains_only (.txt.gz) domain names, one per line. e.g. abtdomain.com
  • basic_info (.csv.gz) domain, registration date, expiration date. e.g. abtdomain.com,2026-06-30,2027-06-30
  • full_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.com
date stringoptional
Date in YYYY-MM-DD format. Defaults to the latest daily file.
Request
# Use -L to follow the redirect, -J -O to save with server filename curl -L -J -O \ "https://premium-api.domainkits.com/api/v1/nrds/download?tld=com&type=domains_only" \ -H "Authorization: Bearer dk_xxx"
Response
HTTP/1.1 302 Found Location: https://download.domainkits.com/... # The redirect URL serves the .txt.gz file directly. # After 10 downloads of the same file: { "success": false, "error": "You have reached the maximum download limit (10 times) for this file." }
GET /api/v1/usage

View the credits you have used and have left, per endpoint.

Request
curl "https://premium-api.domainkits.com/api/v1/usage" \ -H "Authorization: Bearer dk_xxx"
Response
{ "success": true, "endpoints": { "search": { "minute": { "used": 5, "limit": 0 }, "daily": { "used": 42, "limit": 0 } }, ... } }
Credits

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 credits602,000unlimitedunlimited50,000
Hostname credits1010030unlimited500
Export credits210
100 / month
10100
1,000 / month
50,000
WHOIS credits3050050unlimited
DNS credits60500unlimitedunlimited
Reverse NS credits20100unlimited5001,000
Domain Changes credits202,000unlimitedunlimited1,000
TLD Check credits20600unlimitedunlimited
IP Lookup credits2020050unlimited
Registrar credits2020050unlimited
Status Guide credits30unlimitedunlimitedunlimited
TLD Trends credits30unlimitedunlimitedunlimited
Keyword Trends credits20unlimitedunlimitedunlimitedP:50 / Plat:100
CT Subdomains credits1020020unlimited10,000
CT Certs credits1020020unlimited5,000
Typosquat credits120unlimitedunlimited
NRDs Download (not counted in credits)unlimitedunlimitedunlimitedunlimited10 per file
Usage credits30unlimited30unlimited
Per-minute Credit Headers
# On every metered response, in credits. # The Reset value is the unix time the # current per-minute window rolls over. X-RateLimit-Limit: 20 X-RateLimit-Remaining: 17 X-RateLimit-Reset: 1719744000
429 Response
{ "success": false, "error": "Rate limit exceeded (20/min). Wait and retry." }
NRDs Country Codes

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.

With second-level suffixes 114 codes
Covers the code and its second-level suffixes, such as 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 zm
Top level only 33 codes
Covers only domains registered directly under the code, such as example.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
Request (one country, whole family)
curl "https://premium-api.domainkits.com/api/v1/search/nrds?tld=br" \ -H "Authorization: Bearer dk_xxx"
Request (keyword, only these country codes)
curl "https://premium-api.domainkits.com/api/v1/search/nrds?query=shop&cctld=jp,za" \ -H "Authorization: Bearer dk_xxx"