Endpoint
POST https://api.requiems.xyz/v1/text/words/batch
Batch Define Words
Resolve multiple words in a single request. Returns dictionary entries when found, or error information when a word is not in the dataset.
Parameters
| Name | Type | Required | Location | Description |
|---|---|---|---|---|
items |
array | yes | body | List of words to look up in batch (max 50 items) |
Request Example
{
"items": ["ephemeral", "serendipity", "melancholy"]
}
Response Example
{
"data": {
"results": [
{
"word": "serendipity",
"found": true,
"entry": {
"word": "serendipity",
"phonetic": "/ˌserənˈdipədē/",
"definitions": [
{
"part_of_speech": "noun",
"definition": "the occurrence of events by chance in a happy way"
}
],
"synonyms": ["fluke", "chance", "fortuity"]
}
},
{
"word": "fakeword",
"found": false,
"error": "word not found: fakeword"
}
],
"total": 3
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
results |
array | List of batch lookup results |
total |
integer | Total number of items processed |
Errors
undefined422 — Invalid or empty items array