# Domain appraisal API

Read the estimated value of a domain name, run a fresh appraisal, and see a summary of the similar sales behind the figure. The sales summary is free with no key, the value needs a key, and a fresh run needs a paid RapidAPI subscription or the Investor plan.

- Without a key: a summary of the similar sales behind a name, with how many there are, their median price and how many endings its word sold on.
- With a key: the stored value estimate with its recent history. A fresh appraisal run needs a paid RapidAPI subscription or the Investor plan.
- Free calls need no key: 60 calls an hour and 100 a day from one address.

## Try it

```bash
curl -X GET "https://api.unique.domains/v1/names/get.plumbing/comps"
```

## Example answer

200, application/json

```json
{
  "data": {
    "tier": "same_word",
    "count": 10,
    "medianUsd": 2677,
    "endingsSoldOn": 0
  },
  "meta": {
    "asOf": null,
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/get.plumbing/comps",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

## Endpoints

- [GET /names/{name}/value](https://unique.domains/api/get-name-value) (Paid): The stored 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 stored 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.

## Ways to call it

- On RapidAPI: Domain Appraisal API, https://rapidapi.com/dopamyn-network-dopamyn-network-default/api/domain-appraisal3
- From Node.js: `npm install @uniquedomains/domain-appraisal`, or `npx @uniquedomains/domain-appraisal get.plumbing`
- From any language: https://unique.domains/api

## Questions

### Is domain appraisal free?

The sales summary behind a name is free: no key, 60 calls an hour and 100 a day from one address. The value estimate needs a paid RapidAPI subscription to the Domain Appraisal API, or a member key from the Founder or Investor plan, and a fresh appraisal run needs a paid RapidAPI subscription to the Domain Appraisal API, or a member key on the Investor plan. A run counts one appraisal only when it runs.

### What if a name has no estimate yet?

The current estimate is null until one is stored. POST /names/{name}/appraise runs one for a stored name; while another call is running it, the answer is 202 with a Retry-After header.

### Does it list the sales behind the value?

No. The answer is a summary: how many similar sales there are, their median price and how many endings the word sold on. It never lists a sale, its venue or its date.

Full reference: https://unique.domains/api