Usage and limits

API Limits

Type of limit	Maximum limit
Total request size	128 KiB (128*1024 bytes)
Character count	500,000 characters per month for DeepL API Free

Maximum Upload Limits Per Document Format

File Format	DeepL API Free	DeepL API Pro
Word (.docx / .doc)	10 MB 500,000 characters	30 MB 1 million characters
PowerPoint (.pptx)	10 MB 500,000 characters	30 MB 1 million characters
Excel (.xlsx)	10 MB 500,000 characters	30 MB 1 million characters
PDF (.pdf)	10 MB 500,000 characters	30 MB 1 million characters
Text (.txt)	1 MB 500,000 characters	1 MB 1 million characters
HTML (.html)	5 MB 500,000 characters	5 MB 1 million characters
XLIFF (.xlf/.xliff)*	10 MB 500,000 characters	10 MB 1 million characters
SRT (.srt)	150 KB 500,000 characters	150 KB 1 million characters

*Please note that DeepL only supports .xliff files with the version 2.1.

Your Usage

Retrieve usage information within the current billing period together with the corresponding account limits.

Usage is returned and tracked for translated characters. Note that for text translation, characters are still counted toward billing when the source and target languages are equal.

Character usage includes both text and document translations, and is measured by the source text length in Unicode code points. For example, "A", "Δ", "あ", and "深" are each counted as a single character.

Check Usage and Limits

GEThttps://api.deepl.com/v2/usage

Authorization

auth_header

Response

200400403404413429456500504529

The account's usage and limits.

Body

application/json

character_countinteger (int64)

Characters translated so far in the current billing period.

Example: 180118

character_limitinteger (int64)

Current maximum number of characters that can be translated per billing period. If cost control is set, the cost control limit will be returned in this field.

Example: 1250000

Response

200

{
  "character_count": 180118,
  "character_limit": 1250000
}