API Reference/

Dictionary API

Multi-Language Lookup

The Dictionary API supports 871 languages with over 10 million entries. Pass the lang query parameter to any Word Lookup or Prefix Search request. Definitions, etymology, and word forms are returned from the source language's Wiktionary data.

The lang Parameter

Pass any ISO 639 language code as the lang query parameter. Defaults to en (English) when omitted. Use GET /v1/dictionary/languages to get the full list of available languages and their entry counts. If an unsupported language code is provided, the API returns a 404 LANGUAGE_NOT_FOUND error.

Pass ?examples=true to include usage examples in definitions (e.g. "examples": ["¡Hola! ¿Cómo estás?"]). All filtering parameters (pos, fields, definitions, examples) work with any language.

Examples

GET/api/v1/dictionary/hola?lang=es

Requires API key

Spanish word lookup.

Request

bash
curl "https://api.playanagrama.com/api/v1/dictionary/hola?lang=es" \
  -H "Authorization: Bearer ak_your_key_here"

Response 200 — Spanish

JSON
{
  "word": "hola",
  "lang": "es",
  "results": [
    {
      "pos": "intj",
      "definitions": [
        {
          "gloss": "hello, hi, hey",
          "examples": [
            "Hola! Como estas?"
          ]
        }
      ],
      "etymology": "Probably from French hola (\"hey! stop!\")..."
    }
  ]
}

GET/api/v1/dictionary/bonjour?lang=fr

Requires API key

French word lookup.

Request

bash
curl "https://api.playanagrama.com/api/v1/dictionary/bonjour?lang=fr" \
  -H "Authorization: Bearer ak_your_key_here"

Response 200 — French

JSON
{
  "word": "bonjour",
  "lang": "fr",
  "results": [
    {
      "pos": "intj",
      "definitions": [
        {
          "gloss": "good morning, good afternoon, hello"
        }
      ]
    },
    {
      "pos": "noun",
      "definitions": [
        {
          "gloss": "greeting"
        }
      ],
      "forms": [
        {
          "form": "bonjours",
          "tags": [
            "plural"
          ]
        }
      ]
    }
  ]
}

GET/api/v1/dictionary/%E7%8C%AB?lang=ja

Requires API key

Japanese word lookup. Non-ASCII characters should be URL-encoded (%E7%8C%AB = 猫).

Request

bash
curl "https://api.playanagrama.com/api/v1/dictionary/%E7%8C%AB?lang=ja" \
  -H "Authorization: Bearer ak_your_key_here"

Response 200 — Japanese

JSON
{
  "word": "猫",
  "lang": "ja",
  "results": [
    {
      "pos": "noun",
      "definitions": [
        {
          "gloss": "cat (domestic cat)"
        }
      ]
    }
  ]
}

Invalid Language

Requesting an unsupported language code returns a 404 with a hint to check available languages:

Response 404
{
  "error": {
    "code": "LANGUAGE_NOT_FOUND",
    "message": "No dictionary available for language 'zzzz'.",
    "available": "Use GET /v1/dictionary/languages for supported languages."
  }
}

Top Languages by Entries

The 10 largest languages by entry count. Use GET /v1/dictionary/languages for the full list of all 871 languages.

LanguageCodeEntries
Englishen1,440,974
Latinla878,330
Spanishes796,482
Italianit620,479
Russianru439,895
Portuguesept424,046
Frenchfr398,236
Germande362,384
Swedishsv307,556
Finnishfi263,658
Was this page helpful?
Anagrama API Docs | Developer Reference