Introduction

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

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.

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!"
    }
  ]
}

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!"
    }
  ]
}

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!

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.

Start Developing

Cookbook - Explore a large variety of examples from both internal and external contributors for using the DeepL API for different applications.
Guides - Discover additional examples and guides for using the DeepL API.
Your First API Request - Get started quickly with DeepL.

Community and Support

Support Center

Discord Community

Status Page

Release Notes

Getting Started

Learning & How Tos

Best Practices

XML and HTML handling

Resources

Get an API Key and Get Started

Start Developing

Community and Support

Getting Started

Learning & How Tos

Best Practices

XML and HTML handling

Resources

​Get an API Key and Get Started

​Start Developing

​Community and Support

Get an API Key and Get Started

Start Developing

Community and Support