Dictionary API
Fields & Definitions
Control which fields are returned and how many definitions to include. Use fields to select specific response fields and definitions to cap the number of definitions per entry.
Available Fields
definitionsetymologyformssynonymsantonymsderivedrelatedhyponymshypernyms
The pos field is always included regardless of the fields parameter. Unknown field names are silently ignored.
GET/api/v1/dictionary/gratis?fields=synonyms,antonyms
Requires API key
Select specific fields to include in the response. Only requested fields are returned — ideal for thesaurus-style lookups or when you only need specific data.
Query Parameters
| Name | Description |
|---|---|
fields | stringComma-separated list of fields to include. Defaults to (all). |
Request
bash
curl "https://api.playanagrama.com/api/v1/dictionary/gratis?fields=synonyms,antonyms" \
-H "Authorization: Bearer ak_your_key_here"Response 200 — Fields filtered
JSON
{
"word": "gratis",
"lang": "en",
"results": [
{
"pos": "adv"
},
{
"pos": "adj",
"synonyms": [
"complimentary",
"costless",
"chargeless",
"free",
"free of charge"
],
"antonyms": [
"nonfree"
]
}
]
}Fields not requested are omitted entirely. The adverb entry above has no synonyms or antonyms, so only
pos is returned for it.GET/api/v1/dictionary/bonnet?pos=noun&definitions=2
Requires API key
Cap the number of definitions returned per entry. Useful for words like “run” with 50+ definitions.
Query Parameters
| Name | Description |
|---|---|
definitions | integerMaximum definitions per entry (1–50). Defaults to (all). |
Request
bash
curl "https://api.playanagrama.com/api/v1/dictionary/bonnet?pos=noun&definitions=2" \
-H "Authorization: Bearer ak_your_key_here"Response 200 — Capped at 2
JSON
{
"word": "Bonnet",
"lang": "en",
"results": [
{
"pos": "noun",
"definitions": [
{
"gloss": "A type of hat, once worn by women or children, held in place by ribbons tied under the chin."
},
{
"gloss": "The hinged cover over the engine of a motor car, also known as a hood in chiefly Canada and the US."
}
]
}
]
}Was this page helpful?