Quickstart

Get an API key and get started

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

1. Sign up for the API

   Visit our plans page, choose a plan, and sign up.

   If you already have a DeepL Translator account, you will need to log out and create a new account.

2. Test your API key with a request

   Find your API key here. Then try making a simple translation request.

   HTTP Request

   If you chose a free API plan, replace https://api.deepl.com with https://api-free.deepl.com.

   Sample request

   POST /v2/translate HTTP/2
   Host: api.deepl.com
   Authorization: DeepL-Auth-Key [yourAuthKey] 
   User-Agent: YourApp/1.2.3
   Content-Length: 45
   Content-Type: application/json
   
   {"text":["Hello, world!"],"target_lang":"DE"}
   

   Sample response

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

   cURL

   If you chose a free API plan, replace https://api.deepl.com with https://api-free.deepl.com.

   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

   Install client library

   pip install deepl
   

   Sample request

   import deepl
   
   auth_key = "{YOUR_API_KEY}" # replace with your key
   deepl_client = deepl.DeepLClient(auth_key)
   
   result = deepl_client.translate_text("Hello, world!", target_lang="DE")
   print(result.text)
   

   Sample output

   Hallo, Welt!
   

   In production code, it’s safer to store your API key in an environment variable.

   JavaScript

   Install client library

   npm install deepl-node
   

   Sample request

   import * as deepl from 'deepl-node';
   
   const authKey = "{YOUR_API_KEY}"; // replace with your key
   const deeplClient = new deepl.DeepLClient(authKey);
   
   (async () => {
       const result = await deeplClient.translateText('Hello, world!', null, 'de');
       console.log(result.text);
   })();
   

   Sample output

   Hallo, Welt!
   

   In production code, it’s safer to store your API key in an environment variable.

   PHP

   Install client library

   composer require deeplcom/deepl-php
   

   Sample request

   require_once 'vendor/autoload.php';
   use DeepL\Client;
   
   $authKey = "{YOUR_API_KEY}"; // replace with your key
   $deeplClient = new DeepL\DeepLClient($authKey);
   
   $result = $deeplClient->translateText('Hello, world!', null, 'de');
   echo $result->text;
   

   Sample output

   Hallo, Welt!
   

   In production code, it’s safer to store your API key in an environment variable.

   C#

   Install client library

   dotnet add package DeepL.net
   

   Sample request

   using DeepL; // this imports the DeepL namespace. Use the code below in your main program.
   
   var authKey = "{YOUR_API_KEY}"; // replace with your key
   var client = new DeepLClient(authKey);
   
   var translatedText = await client.TranslateTextAsync(
       "Hello, world!",
       null,
       LanguageCode.German);
   Console.WriteLine(translatedText);
   

   Sample output

   Hallo, Welt!
   

   In production code, it’s safer to store your API key in an environment variable.

   Java

   Install client library

   // For instructions on installing the DeepL Java library,
   // see https://github.com/DeepLcom/deepl-java?tab=readme-ov-file#installation
   

   Sample request

   import com.deepl.api.*;
   
   public class Main {
       public static void main(String[] args) throws DeepLException, InterruptedException {
           String authKey = "{YOUR_API_KEY}"; // replace with your key
           DeepLClient client = new DeepLClient(authKey);
   
           TextResult result = client.translateText("Hello, world!", null, "de");
           System.out.println(result.getText());
       }
   }
   

   Sample output

   Hallo, Welt!
   

   In production code, it’s safer to store your API key in an environment variable.

   Ruby

   Install client library

   gem install deepl-rb
   

   Sample request

   require 'deepl'
   
   DeepL.configure do |config|
       config.auth_key = '{YOUR_API_KEY}' # replace with your key
   end
   
   translation = DeepL.translate 'Hello, world!', nil, 'de'
   puts translation.text
   

   Sample output

   Hallo, Welt!
   

   In production code, it’s safer to store your API key in an environment variable.

3. Keep building

   Pick the product you want to integrate:

   Translate

   Translate text strings and complete documents, with quickstarts for both.

   Voice

   Transcribe and translate spoken audio in real time, starting with the Real-Time Voice Quickstart.

   Admin

   Manage API keys, permissions, and usage across your organization, in the account UI or via the Admin API.

   Our official client libraries wrap the API for Python, JavaScript, PHP, .NET, Java, and Ruby, and the community maintains libraries for more languages, including Dart, Go, and Rust.

Keep exploring

• Cookbook - Short tutorials, examples, projects, and use cases
• Guides - In-depth explanations for API features and real-world applications
• Docs MCP Server - Connect your AI tools to this documentation for source-grounded answers

Community and Support

Support Center

Discord Community

API Status Page

DeepL Status Page (all services)

Release Notes