Introduction

Welcome to the developer home of the DeepL API!

Get an API Key and Get Started

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

Step 2: Test your API key with a request.

Here are a few simple options that you can start with. Choose any one, making sure to replace {YOUR_API_KEY}with the API key you just obtained.

If you signed up for a free API account, replace https://api.deepl.com with https://api-free.deepl.com.

Open a terminal. Then:

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. Then:

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. Then:

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!

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

Our client libraries let you use the API with six popular programming languages - Python, JavaScript, C#, PHP, Java, and Ruby.

You can also explore our guides, quick examples, and community-contributed code samples and libraries.

Start Developing

Cookbook - Explore short tutorials, projects, and use cases for the DeepL API.
Guides - Discover longer examples and guides for using the DeepL API.
Your first API request - Get started quickly with DeepL.

Community and Support

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

Last updated 1 month ago