Managing glossaries with the DeepL API

Yes, you can use the glossary functions to create, inspect, and delete glossaries with the DeepL API. Glossaries created via the DeepL API can be used by specifying the glossary_id parameter and are available at https://api.deepl.com/v2/glossaries.

Glossaries created via the DeepL API are distinct from glossaries created via the DeepL website and DeepL desktop apps. This means that API glossaries can't be used on the DeepL website and DeepL desktop apps and vice versa.

It is, however, possible to download your glossary created via the DeepL website or DeepL desktop apps as a CSV file, which you can upload* to create a new glossary in the API.

 

With your DeepL API (Free and Pro) subscription, you can create up to 1,000 glossaries. Please keep in mind that the maximum size limit for a glossary is 10 MB and each source/target text as well as the name of the glossary is limited to 1024 UTF-8 bytes.

 

Currently, you can create glossaries for the DeepL API with the same languages which are available for glossaries on the DeepL website and DeepL desktop apps:

• Chinese
• Danish
• Dutch
• English
• French
• German
• Italian
• Japanese
• Korean
• Norwegian
• Polish
• Portuguese
• Romanian
• Russian
• Spanish
• Swedish

You can create glossaries for any combination of these languages. Your API glossary should include only one language combination (e.g., English into German).

Further languages will be added in the near future.

Please consult the API documentation for more detailed information on how you can create a glossary, list all your created glossaries, get details about a specific glossary, list entries of a glossary and delete a glossary.

Please note that the glossary API does not offer an edit function. You can implement the edit functionality yourself by creating a new glossary with the modified entries and deleting the old glossary.

*

Uploading CSV files is only possible with some of our client libraries (e.g. Python).