Dictionary
Get word definitions, IPA phonetics, usage examples, and synonyms in a single request. Perfect for vocabulary tools, writing assistants, and educational applications.
Descripción general
Casos de uso
- Vocabulary learning and flashcard apps
- Writing assistance and enrichment tools
- Educational platforms and language learning
- Word game development
- Content creation and SEO tools
Funcionalidades
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
Puntos finales de la API
Dictionary Lookup
Returns the definition, phonetics, examples, and synonyms for the given word.
GET
https://requiems.xyz/v1/text/dictionary/{word}
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| word | string |
Obligatorio | The word to look up in the dictionary |
Pruébalo
Demostración en vivoSolicitud
The word to look up in the dictionary
Sending request...
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| 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 |
Ejemplos de código
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(', ')}"
Respuestas de error
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
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| items | array<string> |
Obligatorio | List of words to look up in batch (max 50 items) |
Pruébalo
Demostración en vivoSolicitud
List of words to look up in batch (max 50 items)
Sending request...
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| results | array<object> |
List of batch lookup results |
| total | integer |
Total number of items processed |
Ejemplos de código
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']
Respuestas de error
422
unprocessable_entity
Invalid or empty items array
Preguntas frecuentes
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.