API Docs

Translate words programmatically via a simple REST API.

Quickstart

Request
curl -G https://api.thedictionary.dev/entries/hello \
  -d src=en \
  -d tgt=es \
  -H "x-api-key: your_api_key_here"
Response
{
  "dictionaryEntry": {
    "sourceLangCode": "en",
    "targetLangCode": "es",
    "word": "hello",
    "lemma": "hello",
    "isLemma": true,
    "frequencyCount": 0,
    "data": {
      "transliteration": "",
      "entries": [
        {
          "wordType": "interjección",
          "definitions": [
            {
              "translations": [
                "hola"
              ],
              "definition": "Saludo utilizado al encontrarse con alguien o al comenzar una conversación, especialmente por teléfono.",
              "examples": [
                {
                  "original": "Hello, how are you doing today?",
                  "translation": "Hola, ¿cómo estás hoy?"
                }
              ]
            }
          ]
        },
        {
          "wordType": "sustantivo",
          "definitions": [
            {
              "translations": [
                "saludo",
                "hola"
              ],
              "definition": "La expresión o el acto de decir 'hola'.",
              "examples": [
                {
                  "original": "She gave a friendly hello to everyone in the room.",
                  "translation": "Ella dio un saludo amistoso a todos en la habitación."
                }
              ]
            }
          ]
        },
        {
          "wordType": "verbo",
          "definitions": [
            {
              "translations": [
                "saludar"
              ],
              "definition": "Decir 'hola' a alguien.",
              "examples": [
                {
                  "original": "He helloed the guests as they arrived.",
                  "translation": "Él saludó a los invitados cuando llegaron."
                }
              ]
            }
          ]
        }
      ]
    }
  },
  "isCacheHit": true
}

Authentication

Include your API key in the x-api-key header.

Create keys from your dashboard.

Endpoint

GET /entries/{word}?src=en&tgt=es

word

The word or phrase to look up

src

ISO language code (e.g. en, es, de, ja)

tgt

ISO language code (e.g. en, es, de, ja)

Batch lookup

Endpoint

POST /entries/batch

words

Array of words to look up (max 100).

src

ISO language code (e.g. en, es, de, ja)

tgt

ISO language code (e.g. en, es, de, ja)

Request
curl -X POST https://api.thedictionary.dev/entries/batch \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '
    "words": ["hello", "gmkdmfer", "seeing"],
    "src": "en",
    "tgt": "es"
  }'
Response
{
  "results": [
    {
      "word": "hello",
      "dictionaryEntry": {
        "sourceLangCode": "en",
        "targetLangCode": "en",
        "word": "hello",
        "lemma": "hello",
        "isLemma": true,
        "frequencyCount": 0,
        "data": {
          "transliteration": "",
          "entries": [
            {
              "wordType": "interjection",
              "definitions": [
                {
                  "translations": [],
                  "definition": "used to greet someone, answer the telephone, or attract attention",
                  "examples": [
                    {
                      "original": "Hello, how are you today?",
                      "translation": "Hello, how are you today?"
                    }
                  ]
                }
              ]
            },
            {
              "wordType": "noun",
              "definitions": [
                {
                  "translations": [],
                  "definition": "an utterance of 'hello'; a greeting",
                  "examples": [
                    {
                      "original": "She gave a friendly hello as she walked by.",
                      "translation": "She gave a friendly hello as she walked by."
                    }
                  ]
                }
              ]
            },
            {
              "wordType": "verb",
              "definitions": [
                {
                  "translations": [],
                  "definition": "to greet with 'hello'",
                  "examples": [
                    {
                      "original": "They helloed each other when they met at the door.",
                      "translation": "They helloed each other when they met at the door."
                    }
                  ]
                }
              ]
            }
          ]
        }
      },
      "found": true,
      "isCacheHit": true
    },
    {
      "word": "gmkdmfer",
      "dictionaryEntry": null,
      "found": false,
      "isCacheHit": false
    },
    {
      "word": "seeing",
      "dictionaryEntry": {
        "sourceLangCode": "en",
        "targetLangCode": "en",
        "word": "seeing",
        "lemma": "see",
        "isLemma": false,
        "frequencyCount": 0,
        "data": {
          "transliteration": "",
          "entries": [
            {
              "wordType": "verb",
              "definitions": [
                {
                  "translations": [],
                  "definition": "to perceive with the eyes; discern visually",
                  "examples": [
                    {
                      "original": "I can see the mountains in the distance.",
                      "translation": "I can see the mountains in the distance."
                    }
                  ]
                },
                {
                  "translations": [],
                  "definition": "to understand, realize, or grasp a fact or idea",
                  "examples": [
                    {
                      "original": "I see what you mean.",
                      "translation": "I understand your point."
                    }
                  ]
                },
                {
                  "translations": [],
                  "definition": "to meet or visit someone, or to consult a professional",
                  "examples": [
                    {
                      "original": "I am going to see my doctor tomorrow.",
                      "translation": "I am going to consult with my doctor tomorrow."
                    }
                  ]
                },
                {
                  "translations": [],
                  "definition": "to experience or witness an event or time period",
                  "examples": [
                    {
                      "original": "She has seen many changes in the industry.",
                      "translation": "She has witnessed many changes in the industry."
                    }
                  ]
                },
                {
                  "translations": [],
                  "definition": "to ensure or make sure of something",
                  "examples": [
                    {
                      "original": "Please see that the door is locked.",
                      "translation": "Please ensure that the door is locked."
                    }
                  ]
                }
              ]
            },
            {
              "wordType": "noun",
              "definitions": [
                {
                  "translations": [],
                  "definition": "the office, jurisdiction, or seat of a bishop or archbishop",
                  "examples": [
                    {
                      "original": "The Holy See is the jurisdiction of the Pope.",
                      "translation": "The Holy See is the jurisdiction of the Pope."
                    }
                  ]
                }
              ]
            }
          ]
        }
      },
      "found": true,
      "isCacheHit": true
    }
  ]
}

Pricing

1 request = $0.00001 · 100,000 requests = $1.00

First 10,000 requests are free. Top up from your dashboard.