# Batch words

`POST https://api.unique.domains/v1/words/batch`

Up to 100 word profiles in one call.

One entry per key, in the request's order: the profile of `GET /words/{word}`, or `{ word, found: false }` for a key the catalog does not answer (unknown, disabled, or never shown). Billed one request per key sent, misses included.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call.
- Plan: Investor plan. A Founder key answers 403 `plan_required`.
- Formats: JSON
- API: Word Intelligence API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |
| `words` | string[] | Required | Body | 1 to 100 keys, each a spelling, a slug or `wrd_<id>`. |

## Sample request

```bash
curl -X POST "https://api.unique.domains/v1/words/batch" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "words": [
      "harbor",
      "wrd_48214"
    ]
  }'
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | `wrd_<id>`. |
| `word` | string |  |
| `slug` | string \| null |  |
| `shape` | string \| null |  |
| `pos` | string \| null | Parts of speech as stored, comma-joined tags. |
| `definition` | string \| null |  |
| `inflected` | boolean \| null |  |
| `size` | integer \| null |  |
| `popularity` | integer \| null | How widely the word is used; never sales or demand. |
| `sentiment` | integer \| null | 50 is neutral. |
| `brandability` | integer \| null |  |
| `style` | string \| null |  |
| `categories` | object[] |  |
| `denyClass` | string \| null | Why the word stays off public lists; null when none. |
| `origin` | string |  |
| `addedAt` | string \| null | When the intake added it; null means the dictionary load. |
| `linguistics` | object |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`validation_failed`](https://unique.domains/api/problems/validation_failed) | 400 | A value is not valid |
| [`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": [
    {
      "id": "wrd_48213",
      "word": "harbor",
      "slug": "harbor",
      "shape": "single",
      "origin": "dictionary",
      "popularity": 71
    },
    {
      "word": "harborr",
      "found": false
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/words/batch",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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