Dictionary
Get word definitions, IPA phonetics, usage examples, and synonyms in a single request. Perfect for vocabulary tools, writing assistants, and educational applications.
Overview
Use Cases
- Vocabulary learning and flashcard apps
- Writing assistance and enrichment tools
- Educational platforms and language learning
- Word game development
- Content creation and SEO tools
Features
IPA phonetic transcriptions
Multiple definitions per word (noun, adjective, verb, etc.)
Usage examples for each definition
Synonyms included in every response
Case-insensitive lookup
Fast, low-latency in-memory responses
API Endpoints
Dictionary Lookup
Returns the definition, phonetics, examples, and synonyms for the given word.
GET
https://requiems.xyz/v1/text/dictionary/{word}
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| word | string |
Required | The word to look up in the dictionary |
Try it out
Live DemoRequest
The word to look up in the dictionary
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| word | string |
The normalized (lowercased) word that was looked up |
| phonetic | string |
IPA phonetic transcription of the word (may be omitted if unavailable) |
| definitions | array<object> |
One or more definitions for the word, each with part_of_speech, definition, and an optional example |
| definitions[].part_of_speech | string |
Grammatical category (e.g. noun, verb, adjective) |
| definitions[].definition | string |
Plain-text definition of the word |
| definitions[].example | string |
Example sentence using the word (may be omitted) |
| synonyms | array<string> |
List of words with similar meaning |
Code Examples
curl https://requiems.xyz/v1/text/dictionary/ephemeral \
-H "requiems-api-key: YOUR_API_KEY"import requests
url = "https://requiems.xyz/v1/text/dictionary/ephemeral"
headers = {"requiems-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
data = response.json()['data']
print(f"{data['word']} {data['phonetic']}")
for d in data['definitions']:
print(f" [{d['part_of_speech']}] {d['definition']}")
if d.get('example'):
print(f" Example: {d['example']}")
print(f"Synonyms: {', '.join(data['synonyms'])}")const response = await fetch('https://requiems.xyz/v1/text/dictionary/ephemeral', {
headers: {
'requiems-api-key': 'YOUR_API_KEY'
}
});
const { data } = await response.json();
console.log(`${data.word} ${data.phonetic}`);
data.definitions.forEach(d => {
console.log(` [${d.part_of_speech}] ${d.definition}`);
if (d.example) console.log(` Example: ${d.example}`);
});
console.log('Synonyms:', data.synonyms.join(', '));require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/text/dictionary/ephemeral')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)['data']
puts "#{data['word']} #{data['phonetic']}"
data['definitions'].each do |d|
puts " [#{d['part_of_speech']}] #{d['definition']}"
puts " Example: #{d['example']}" if d['example']
end
puts "Synonyms: #{data['synonyms'].join(', ')}"Error Responses
not_found
The word was not found in the dictionary dataset.
bad_request
The word path parameter is missing.
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.
POST
https://requiems.xyz/v1/text/words/batch
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| items | array<string> |
Required | List of words to look up in batch (max 50 items) |
Try it out
Live DemoRequest
List of words to look up in batch (max 50 items)
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| results | array<object> |
List of batch lookup results |
| total | integer |
Total number of items processed |
Code Examples
curl -X POST "https://requiems.xyz/v1/text/words/batch" \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["example"]}'import requests
url = "https://requiems.xyz/v1/text/words/batch"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = { "items": ["example"] }
response = requests.post(url, headers=headers, json=payload)
print(response.json()["data"])const response = await fetch('https://requiems.xyz/v1/text/words/batch', {
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ 'items': ["example"] })
});
const { data } = await response.json();
console.log(data);require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/text/words/batch')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = { "items" => ["example"] }.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts JSON.parse(response.body)['data']Error Responses
422
unprocessable_entity
Invalid or empty items array
Frequently Asked Questions
No, the lookup is case-insensitive. Searching for "Ephemeral", "EPHEMERAL", or "ephemeral" all return the same result.
The API returns a 404 Not Found response with the error code "not_found" if the word is not in the dictionary dataset.
Yes. Some words function as multiple parts of speech (e.g. both a noun and an adjective) and will have a separate definition entry for each.
The dataset contains a curated set of common English words with full dictionary entries including phonetics, definitions, examples, and synonyms.
Phonetic transcriptions use the International Phonetic Alphabet (IPA) and are included for all words in the current dataset. The phonetic field may be absent for words added in the future if a transcription is not yet available.