API Docs

Translate words programmatically via a simple REST API.

Quickstart

Request
curl -G https://api.thedictionary.dev/entries/hello \
  -d from=en \
  -d to=es \
  -H "x-api-key: your_api_key_here"
Response
{
  "sourceLanguageCode": "en",
  "targetLanguageCode": "es",
  "word": "hello",
  "lemma": "hello",
  "isLemma": true,
  "frequencyCount": 0,
  "transliteration": null,
  "entries": [
    {
      "partOfSpeech": "interjección",
      "senses": [
        {
          "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?"
            }
          ]
        }
      ]
    },
    {
      "partOfSpeech": "sustantivo",
      "senses": [
        {
          "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."
            }
          ]
        }
      ]
    },
    {
      "partOfSpeech": "verbo",
      "senses": [
        {
          "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}?from=en&to=es

word

The word or phrase to look up

from

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

to

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

Batch lookup

Endpoint

POST /entries/batch

words

Array of words to look up (max 100).

from

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

to

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"],
    "from": "en",
    "to": "es"
  }'
Response
{
  "data": [
    {
      "word": "hello",
      "data": {
        "sourceLanguageCode": "en",
        "targetLanguageCode": "es",
        "word": "hello",
        "lemma": "hello",
        "isLemma": true,
        "frequencyCount": 0,
        "transliteration": null,
        "entries": [
          {
            "partOfSpeech": "interjección",
            "senses": [
              {
                "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?"
                  }
                ]
              }
            ]
          },
          {
            "partOfSpeech": "sustantivo",
            "senses": [
              {
                "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."
                  }
                ]
              }
            ]
          },
          {
            "partOfSpeech": "verbo",
            "senses": [
              {
                "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
      },
      "found": true
    },
    {
      "word": "gmkdmfer",
      "data": null,
      "found": false
    },
    {
      "word": "seeing",
      "data": {
        "sourceLanguageCode": "en",
        "targetLanguageCode": "es",
        "word": "seeing",
        "lemma": "see",
        "isLemma": false,
        "frequencyCount": 0,
        "transliteration": null,
        "entries": [
          {
            "partOfSpeech": "verbo",
            "senses": [
              {
                "translations": [
                  "ver",
                  "mirar"
                ],
                "definition": "Percibir objetos mediante el sentido de la vista.",
                "examples": [
                  {
                    "original": "I can see the mountains from here.",
                    "translation": "Puedo ver las montañas desde aquí."
                  }
                ]
              },
              {
                "translations": [
                  "entender",
                  "comprender"
                ],
                "definition": "Captar o comprender una idea o situación.",
                "examples": [
                  {
                    "original": "I see what you mean.",
                    "translation": "Entiendo lo que quieres decir."
                  }
                ]
              },
              {
                "translations": [
                  "reunirse con",
                  "visitar"
                ],
                "definition": "Encontrarse con alguien o tener una cita.",
                "examples": [
                  {
                    "original": "Are you seeing him tomorrow?",
                    "translation": "¿Te vas a reunir con él mañana?"
                  }
                ]
              },
              {
                "translations": [
                  "comprobar",
                  "verificar"
                ],
                "definition": "Asegurarse de algo o examinar una situación.",
                "examples": [
                  {
                    "original": "Let me see if the door is locked.",
                    "translation": "Déjame comprobar si la puerta está cerrada."
                  }
                ]
              }
            ]
          }
        ],
        "isCacheHit": true
      },
      "found": true
    }
  ]
}

Pricing

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

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