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

About

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

About

Get an API Key and Get Started

Start Developing

Community and Support

Getting Started

Learning & How Tos

Best Practices

XML and HTML handling

Resources

Introduction

Get an API Key and Get Started

Start Developing

Community and Support

​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

Get an API Key and Get Started

Start Developing

Community and Support