Getting Started
Learning & How Tos
- Cookbook
- Guides
Best Practices
XML and HTML handling
Resources
- Release notes
- Breaking changes (Change Notices)
- Language release process
- Usage and limits
- Open API spec
- DeepL developer community
Getting Started
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
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 athttps://www.deepl.com/en/your-account/keys
Step 2: Test your API key with a request.
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 deeplSample Request File
import deeplauth_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-nodeSample 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 replacehttps://api.deepl.com withhttps://api-free.deepl.com.
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.