Translate your app's text with DeepL from Node or Python

What you get

Your app's UI strings and user content translated by DeepL from a few lines of Node or Python.

Prerequisites

A DeepL API account and an API key from your account settings
Node.js (the library supports 12 through 24) or Python 3.9 to 3.13

Steps

Install the official client library.

Shell

npm install deepl-node

Put your key in an environment variable instead of hard-coding it.

Shell

export DEEPL_AUTH_KEY="your-deepl-api-key"

Create translate.mjs. null as the source language lets DeepL detect it, and you can pass an array to translate many strings in one request.

javascript

import * as deepl from 'deepl-node';

const authKey = process.env.DEEPL_AUTH_KEY;
const deeplClient = new deepl.DeepLClient(authKey);

(async () => {
    const result = await deeplClient.translateText('Hello, world!', null, 'de');
    console.log(result.text);

    const translations = await deeplClient.translateText(['Save changes', 'Your cart is empty'], null, 'fr');
    for (const t of translations) {
        console.log(t.text);
    }
})();

Prefer Python? Install the package and create translate.py instead.

Shell

pip install --upgrade deepl

Python

import os
import deepl

auth_key = os.environ["DEEPL_AUTH_KEY"]
deepl_client = deepl.DeepLClient(auth_key)

result = deepl_client.translate_text("Hello, world!", target_lang="DE")
print(result.text)

Target languages are ISO 639-1 codes; some need a regional variant, for example en-US, en-GB or pt-BR.

Test it

Run node translate.mjs (or python translate.py). You should see Hallo, Welt! followed by the two French strings.

What you'll need

What you get

Prerequisites

Steps

Test it