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.

Please note that 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 language combinations as available for glossaries on the DeepL website and DeepL desktop apps:

• English into German (EN -> DE)
• German into English (DE -> EN)
• English into French (EN -> FR)
• French into English (FR -> EN)
• English into Spanish (EN -> ES)
• Spanish into English (ES -> EN)
• English into Japanese (EN -> JA)
• Japanese into English (JA -> EN)
• English into Italian (EN -> IT)
• Italian into English (IT -> EN)
• English into Polish (EN -> PL)
• Polish into English (PL -> EN)
• German into French (DE -> FR)
• French into German (FR -> DE)
• English into Dutch (EN -> NL)
• Dutch into English (NL -> EN)

Your API glossary should include only one language pair (e.g., English into German).

Further language combinations 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.