# Unique Domains API reference

Domain names, words, TLDs, registrar prices, the market, trends and the agenda, at https://api.unique.domains/v1. Free calls need no key, within 60 calls an hour and 100 a day from one address, and read 20 rows a page.

API status: https://uniquedomains.instatus.com

## First call

```bash
curl "https://api.unique.domains/v1/names/get.plumbing"
```

## Use it from code

- Node.js: `npm install @uniquedomains/sdk`. A typed client for every endpoint, with methods grouped by what they read. Source: https://github.com/UniqueDomains/nodejs
- Command line: `npx @uniquedomains/cli get-name get.plumbing`. Every endpoint as a command, with no install. Source: https://github.com/UniqueDomains/nodejs
- MCP server: `npx -y @uniquedomains/mcp-server`. The API as tools for an AI assistant. Add the hosted server, https://mcp.unique.domains/mcp, with no key, or run it on your machine. Source: https://github.com/UniqueDomains/mcp-server
- Python: `pip install uniquedomains`. A typed client for every endpoint. Source: https://github.com/UniqueDomains/python
- The MCP server in each assistant: https://unique.domains/api/mcp
- The code and the datasets on GitHub: https://github.com/UniqueDomains

## Domain Check API

Any domain name: status, registry record, DNS, prices, value, past sales and its open auction.

- [GET /names/{name}](https://unique.domains/api/get-name) (Free): The answer for one domain name: status, drop day, price today, registry facts, word facts and similar sales.
- [POST /names/batch](https://unique.domains/api/batch-names) (Paid): The keyed name resource for up to 100 names in one call.
- [POST /names/{name}/check](https://unique.domains/api/check-name) (Paid): Runs a live check of one name and returns the keyed name resource.
- [GET /names/{name}/prices](https://unique.domains/api/get-name-prices) (Paid): Every registrar quote for one name, and the renewal-trap flag.
- [GET /names/{name}/registry](https://unique.domains/api/get-name-registry) (Free): The registry record of one name: dates, registrar, status codes, nameservers, DNSSEC and holder.
- [GET /names/{name}/registry/history](https://unique.domains/api/get-name-registry-history) (Paid): The past versions of one name's registry record and what moved between them.
- [GET /names/{name}/dns](https://unique.domains/api/get-name-dns) (Free): The DNS records of one name, with its parking venue.
- [GET /names/{name}/changes](https://unique.domains/api/list-name-changes) (Paid): The change events of one name, newest first.
- [GET /names/{name}/history](https://unique.domains/api/get-name-history) (Paid): The web history of one name as our bands: archive captures, authority band and language.
- [GET /names/{name}/value](https://unique.domains/api/get-name-value) (Paid): The value estimate of one name and its last 20 estimates.
- [POST /names/{name}/appraise](https://unique.domains/api/appraise-name) (Paid): Runs the appraisal of one catalog name when its estimate is missing, and returns the value resource.
- [GET /names/{name}/comps](https://unique.domains/api/get-name-comps) (Free): The similar-sales aggregate of one name and how many endings its word sold on.
- [GET /names/{name}/auction](https://unique.domains/api/get-name-auction) (Free): The open auction of one name, if any: venue, deadline, bid and the first-year cost.

## Word Intelligence API

The one-word catalog: profiles, endings, names, trademarks, notability, market and the word intake.

- [GET /words/resolve](https://unique.domains/api/resolve-word) (Free): Turns what a caller typed into the catalog word it names, or up to five candidates.
- [GET /words/categories](https://unique.domains/api/list-word-categories) (Free): The catalog's word categories, by name.
- [POST /words/batch](https://unique.domains/api/batch-words) (Paid): Up to 100 word profiles in one call.
- [GET /words](https://unique.domains/api/list-words) (Paid): Searches the catalog's words by text and facets, alphabetically.
- [GET /words/{word}](https://unique.domains/api/get-word) (Paid): A word's profile: definition, facets, categories, origin and linguistics.
- [GET /words/{word}/endings](https://unique.domains/api/get-word-endings) (Free): A word's endings: counts, the key endings, and the endings the word is available on and for sale on.
- [GET /words/{word}/names](https://unique.domains/api/list-word-names) (Paid): A word's catalog names on the endings that sell, by name.
- [GET /words/{word}/trademarks](https://unique.domains/api/get-word-trademarks) (Paid): A word's trademark counts and its exact-match marks.
- [GET /words/{word}/notability](https://unique.domains/api/get-word-notability) (Free): A word's Wikipedia page and Wikidata entry: title, backlinks, languages and description.
- [GET /words/{word}/market](https://unique.domains/api/get-word-market) (Free): A word's sales and auction aggregates.
- [GET /words/{word}/related](https://unique.domains/api/list-related-words) (Paid): A word's synonyms then related words, closest first, with their open names.
- [GET /words/{word}/fit](https://unique.domains/api/list-word-fits) (Paid): How well the word fits each ending whose keywords list it.
- [POST /words/{word}/request](https://unique.domains/api/request-word) (Paid): Brings a word into the catalog: checks it now and queues an accepted word for the intake.
- [GET /words/requests/{requestId}](https://unique.domains/api/get-word-request) (Paid): The state of a word request: queued, ready with its catalog word, refused or failed.

## One-Word Domains API

The tracked one-word names: filtered lists, expiring names, drops, hacks, the change feed and catalog totals.

- [GET /domains](https://unique.domains/api/list-domains) (Free): One-word catalog names under filters.
- [GET /domains/{nameOrId}](https://unique.domains/api/get-domain) (Free): One name the catalog lists, by name or id.
- [GET /domains/expiring](https://unique.domains/api/list-expiring-domains) (Paid): Catalog names expiring or expired, by expiry day.
- [GET /domains/drops](https://unique.domains/api/get-domain-drops) (Free): Names dropping on one day: counts free, names keyed.
- [GET /domains/hacks](https://unique.domains/api/list-domain-hacks) (Free): Domain hacks: names whose ending completes the word.
- [GET /domains/changes](https://unique.domains/api/list-domain-changes) (Paid): The catalog's change feed, newest first.
- [GET /catalog/stats](https://unique.domains/api/get-catalog-stats) (Free): Catalog headline totals.

## TLD Intelligence API

Every ending: registry facts, phases, market statistics, changes, keywords and the ICANN applications.

- [GET /tlds](https://unique.domains/api/list-tlds) (Free): Every root TLD with its registry facts and launch phases, alphabetical.
- [GET /tlds/{tld}](https://unique.domains/api/get-tld) (Free): One TLD in full: registry facts, phases, market, quality band and registrar prices.
- [GET /tlds/{tld}/stats](https://unique.domains/api/get-tld-stats) (Free): The ending's market figures, and with history its daily rows.
- [GET /tlds/{tld}/phases](https://unique.domains/api/list-tld-phases) (Free): Every dated launch phase of the ending, chronological.
- [GET /tlds/{tld}/changes](https://unique.domains/api/list-tld-changes) (Free): The ending's public registry changes, newest first.
- [GET /tlds/{tld}/keywords](https://unique.domains/api/list-tld-keywords) (Free): The keywords the catalog attaches to the ending, by type.
- [GET /tld-applications](https://unique.domains/api/list-tld-applications) (Free): ICANN's 2026 new gTLD round, A to Z, with two simple bands.
- [GET /tld-applications/changes](https://unique.domains/api/list-tld-application-changes) (Free): Every status or contention change of the round, newest first.
- [GET /tld-applications/{string}](https://unique.domains/api/get-tld-application-string) (Free): One applied-for string: its applications and its change history.

## Registrar Prices API

Registrar price lists, price changes, renewal traps, cheapest registrars, venues and the IANA registrar list.

- [GET /registrars](https://unique.domains/api/list-registrars) (Free): The nine registrars whose daily price lists are compared, in catalog order.
- [GET /registrars/{registrar}/prices](https://unique.domains/api/list-registrar-prices) (Free): A registrar's list prices, alphabetical by ending.
- [GET /registrars/{registrar}/changes](https://unique.domains/api/list-registrar-changes) (Free): A registrar's confirmed list-price changes, newest first.
- [GET /registrars/{registrar}/footprint](https://unique.domains/api/get-registrar-footprint) (Paid): Names tracked under the registrar, rounded, with its top endings.
- [GET /prices/tlds/{tld}](https://unique.domains/api/list-tld-prices) (Free): Every registrar's list price for one ending, with the cheapest and trap marks.
- [GET /prices/tlds/{tld}/history](https://unique.domains/api/list-tld-price-history) (Paid): Change-only price rows of one ending, newest first.
- [GET /prices/changes](https://unique.domains/api/list-price-changes) (Free): Confirmed registrar price changes across the nine, newest first.
- [GET /prices/traps](https://unique.domains/api/list-price-traps) (Free): Endings whose cheapest first year renews at a trap price, alphabetical.
- [GET /prices/cheapest](https://unique.domains/api/list-cheapest-prices) (Paid): The cheapest registrar per ending for up to 100 endings.
- [GET /venues](https://unique.domains/api/list-venues) (Free): The parking and marketplace venues with a profile and their rounded footprint.
- [GET /venues/{id}](https://unique.domains/api/get-venue) (Free): One venue's profile with its verified listing terms.
- [GET /iana/registrars](https://unique.domains/api/list-iana-registrars) (Free): The IANA registrar list, by IANA id.
- [GET /iana/registrars/{id}](https://unique.domains/api/get-iana-registrar) (Free): One IANA registrar by id.

## Domain Market API

Domain sales as aggregates and the day's domain auctions.

- [GET /market/sales](https://unique.domains/api/get-market-sales) (Free): The domain sales pulse as headline aggregates: windows, price bands and the sold-before count.
- [GET /market/sales/series](https://unique.domains/api/list-market-sales-series) (Free): One sales series by day, week or month, oldest first.
- [GET /market/sales/endings](https://unique.domains/api/list-market-sales-endings) (Free): Each ending's 12-month and 30-day sales figures, alphabetical.
- [GET /market/sales/lengths](https://unique.domains/api/get-market-sales-lengths) (Free): Sales by label length for .com, .ai, .io and .co.
- [GET /market/sales/movers](https://unique.domains/api/list-market-sales-movers) (Free): Up to ten words whose sales moved over the last 30 days.
- [GET /market/sales/words/{word}](https://unique.domains/api/get-market-sales-word) (Free): One word's sales market over 12 months: count, median, endings sold on and the latest sale's month.
- [GET /market/auctions](https://unique.domains/api/get-market-auctions) (Free): Today's domain auctions by venue, ending and length, the next seven days and the tracked counts.
- [GET /market/auctions/sample](https://unique.domains/api/list-market-auctions-sample) (Free): The day's fixed sample of up to 20 single-word names at auction, by deadline.
- [GET /market/auctions/venues](https://unique.domains/api/list-market-auction-venues) (Free): The seven auction venues with their verified rules and today's counts.
- [GET /market/auctions/outcomes](https://unique.domains/api/list-market-auction-outcomes) (Paid): Confirmed auction outcomes by venue, day and currency, as counts and medians.

## Domain Trends API

The trends behind the daily editions: definitions, searches, growth and categories.

- [GET /trends](https://unique.domains/api/list-trends) (Free): Every published trend with its latest edition figures and its first and last edition day.
- [GET /trends/{slug}](https://unique.domains/api/get-trend) (Free): One trend: its latest row, its head words, its figures at every edition and its observations.
- [GET /trends/categories](https://unique.domains/api/list-trend-categories) (Free): The trend categories, the `category` filter of `GET /trends`.
- [GET /trends/pool](https://unique.domains/api/list-trend-pool) (Paid): The admitted trend candidates the editions draw from, with their observations.

## TLD Launch Calendar API

Industry events and the dated agenda of TLD phases and registry changes, in JSON or iCalendar.

- [GET /events](https://unique.domains/api/list-events) (Free): The industry events of one month, in date order, then the events still without a date.
- [GET /events.ics](https://unique.domains/api/get-events-ics) (Free): The industry events as an iCalendar file.
- [GET /events/{slug}](https://unique.domains/api/get-event) (Free): One industry event with its organizer, location and description.
- [GET /agenda](https://unique.domains/api/get-agenda) (Free): The whole public agenda of one month: industry events, TLD launch phases and registry changes.
- [GET /agenda.ics](https://unique.domains/api/get-agenda-ics) (Free): The whole public agenda as an iCalendar file.

## In every API

- [GET /meta/tlds](https://unique.domains/api/get-meta-tlds) (Free): The v1 TLD list path, redirected to /tlds for one release.
- [GET /editions/{persona}/latest](https://unique.domains/api/get-latest-edition) (Free): The latest published daily edition of one page.
- [GET /editions/{persona}/{date}](https://unique.domains/api/get-edition) (Free): One dated published edition of one page.
- [GET /meta/enums](https://unique.domains/api/get-meta-enums) (Free): Every enum the payloads use.
- [GET /meta/freshness](https://unique.domains/api/get-meta-freshness) (Free): The day's counts and the state of each part of the data.
- [GET /meta/datasets](https://unique.domains/api/list-meta-datasets) (Free): The GitHub datasets and the API path serving the same rows.
- [GET /meta/trademark-classes](https://unique.domains/api/list-meta-trademark-classes) (Free): The 45 Nice classes a trademark is filed under.
- [GET /meta/providers](https://unique.domains/api/get-meta-providers) (Free): Registrar identities and the auction venue and parking service catalogs.
- [GET /meta/key](https://unique.domains/api/get-key) (Paid): The calling key's own plan, allowances and month.
- [GET /meta/openapi.json](https://unique.domains/api/get-openapi) (Free): The OpenAPI document of the API, whole or for one listing, in its 3.1 or 3.0 form.
- [GET /meta/llms.txt](https://unique.domains/api/get-llms-txt) (Free): The free endpoints as plain text for language models.
- [GET /meta/health](https://unique.domains/api/get-health) (Free): Liveness: `ok` with the server time.

## Errors

Every error is `application/problem+json` with a stable `code`. All of them: https://unique.domains/api/problems

## The OpenAPI document

https://api.unique.domains/v1/meta/openapi.json
