Introduction

Welcome to the developer home of DeepL API.

Get an API Key and Get Started

New user? Follow these quick steps to get started with the DeepL API.

Step 1: Sign up for the DeepL API at https://www.deepl.com/en/pro#developer

After logging in, you will find your API keys at https://www.deepl.com/en/your-account/keys

Step 2: Test your API key with a request.

Here are a few simple options that you can start with. Choose any one and replace{YOUR_API_KEY}with your own key.

Curl

Open a terminal.

Set the API key

export API_KEY={YOUR_API_KEY}

Sample request

curl -X POST https://api.deepl.com/v2/translate \
  --header "Content-Type: application/json" \
  --header "Authorization: DeepL-Auth-Key $API_KEY" \
  --data '{
    "text": ["Hello world!"], 
    "target_lang": "DE"
}'

Sample response

{
  "translations": [
    {
      "detected_source_language": "EN",
      "text": "Hallo, Welt!"
    }
  ]
}

Python

Choose a local directory to work in.

Install client library

pip install deepl

Sample Request File

import deepl

auth_key = "{YOUR_API_KEY}"
translator = deepl.Translator(auth_key)

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

Sample Response

Hallo, Welt!

NodeJS

Choose a local directory to work in.

Install client library

npm install deepl-node

Sample Request File

import * as deepl from 'deepl-node';

const authKey = "{YOUR_API_KEY}";
const translator = new deepl.Translator(authKey);

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

Sample Response

Hallo, Welt!

Note: If you are on a free API account, you can replace https://api.deepl.com with https://api-free.deepl.com.

Step 3: Keep building with our client libraries and how-to guides.

You can use our API with popular programming languages (Python, JavaScript, .NET, PHP, Java, Ruby). Click here to learn more about our client libraries. You can also click here to find more examples and guides.

Start Developing

• Cookbook - Explore a large variety of examples from both internal and external contributors for using the DeepL API for different applications.

• Your First API Request - Learn more about how to make your first API request with DeepL.

• Other Examples and Guides - Discover additional examples and guides for using the DeepL API.

Community and Support

• Release Notes - Check out the new features in recent DeepL API releases.

Support Center

Discord Community

Status Page

---

Have feedback about our docs? We'd love to hear from you. Please share your thoughts in our developer community in Discord.