# Get market sales word

`GET https://api.unique.domains/v1/market/sales/words/{word}`

One word's sales market over 12 months: count, median, endings sold on and the latest sale's month.

The word is read as typed up to its first dot (`hive.co.uk` reads `hive`). Free: one word a day per address (the same word again is answered; another answers 429 until the next UTC midnight). A word with a deny class answers 404.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON
- API: Domain Market API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `word` | string | Required | Path | The word, 2 to 63 lowercase letters, digits or inner hyphens. |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |

## Sample request

```bash
curl -X GET "https://api.unique.domains/v1/market/sales/words/hive"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `status` | string |  |
| `word` | string |  |
| `sales12m` | integer |  |
| `median12mUsd` | integer \| null |  |
| `endingsSoldOn` | integer |  |
| `lastSaleMonth` | string \| null | `YYYY-MM`. |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`not_found`](https://unique.domains/api/problems/not_found) | 404 | Not found |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |

## Example answer

200, application/json

```json
{
  "data": {
    "status": "result",
    "word": "hive",
    "sales12m": 11,
    "median12mUsd": 3400,
    "endingsSoldOn": 5,
    "lastSaleMonth": "2026-10"
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/market/sales/words/hive",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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