API Reference/

Dictionary API

Word Lookup

Look up a word's definitions, etymology, inflected forms, synonyms, antonyms, and more. Returns full dictionary entries for an exact match, with all parts of speech. See also Prefix Search for autocomplete-style results and Multi-Language for cross-language lookups.

GET/api/v1/dictionary/:word

Requires API key

Returns full dictionary entries for the given word including all parts of speech, definitions, etymology, word forms, synonyms, antonyms, and related words.

Path Parameters

NameDescription
:wordreq
stringThe word to look up (1–100 characters). URL-encoded for non-ASCII characters.

Query Parameters

NameDescription
lang
stringISO 639 language code (e.g. en, es, fr, de, ja). See Multi-Language for details. Defaults to en.
exact
booleantrue for exact match (full entries). Set to false for prefix search. Defaults to true.
pos
stringFilter by part of speech (e.g. noun, verb, adj, adv, name, intj). Returns only entries matching the given part of speech. Defaults to (all).
fields
stringComma-separated list of fields to include: definitions, etymology, forms, synonyms, antonyms, derived, related, hyponyms, hypernyms. The pos field is always included. Unknown field names are silently ignored. Defaults to (all).
definitions
integerCap definitions per entry (1–50). Useful for words like “run” with 50+ definitions. Defaults to (all).
examples
booleanInclude usage examples inside definitions. Off by default to keep responses lean. Defaults to false.

Request

bash
curl "https://api.playanagrama.com/api/v1/dictionary/bonnet" \
  -H "Authorization: Bearer ak_your_key_here"

Response Fields

NameDescription
word
stringThe canonical casing of the word from the database.
lang
stringThe language code used for the lookup.
results
object[]Array of dictionary entries, one per part of speech.
results[].pos
stringPart of speech: noun, verb, adj, adv, name, intj, etc.
results[].definitions
object[]List of definitions. Each has a gloss string. Pass ?examples=true for usage examples.
results[].etymology
string?Word origin and history (when available).
results[].forms
object[]?Inflected forms (plurals, conjugations, alternative spellings). Each has form and tags.
results[].synonyms
string[]?Synonymous words.
results[].antonyms
string[]?Antonymous words.
results[].derived
string[]?Words derived from this word.
results[].related
string[]?Related words.
results[].hyponyms
string[]?More specific terms (e.g. “dog” is a hyponym of “animal”).
results[].hypernyms
string[]?More general terms (e.g. “animal” is a hypernym of “dog”).

Response 200

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."
        }
      ],
      "etymology": "From Middle English bonet, from Middle French bonet...",
      "forms": [
        {
          "form": "bonnets",
          "tags": [
            "plural"
          ]
        }
      ],
      "synonyms": [
        "tam o'shanter",
        "hood"
      ],
      "derived": [
        "bee in one's bonnet",
        "Scotch bonnet",
        "sunbonnet"
      ],
      "related": [
        "boot"
      ]
    },
    {
      "pos": "verb",
      "definitions": [
        {
          "gloss": "To put a bonnet on."
        },
        {
          "gloss": "To pull the bonnet or cap down over the eyes of."
        }
      ],
      "etymology": "From Middle English bonet...",
      "forms": [
        {
          "form": "bonnets",
          "tags": [
            "present",
            "singular",
            "third-person"
          ]
        },
        {
          "form": "bonneting",
          "tags": [
            "participle",
            "present"
          ]
        },
        {
          "form": "bonneted",
          "tags": [
            "past"
          ]
        }
      ]
    }
  ]
}

Response 404 — Word not found

JSON
{
  "error": {
    "code": "WORD_NOT_FOUND",
    "message": "No entries found for 'xylophone123' in en."
  }
}

Response 401 — Missing API key

JSON
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "A valid API key is required. Pass it as a Bearer token."
  }
}
Not every entry has every field — the API only returns fields that contain data. The word field in the top-level response returns the canonical casing from the database (e.g. “Bonnet” even if you queried “bonnet”). By default, definitions contain only gloss. Pass ?examples=true to also include examples arrays where available.
Was this page helpful?
Anagrama API Docs | Developer Reference