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)	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

*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.

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.

character_limitinteger (int64)

Current maximum number of characters that can be translated per billing period.

document_limitinteger (int64)

Documents translated so far in the current billing period.

document_countinteger (int64)

Current maximum number of documents that can be translated per billing period.

team_document_limitinteger (int64)

Documents translated by all users in the team so far in the current billing period.

team_document_countinteger (int64)

Current maximum number of documents that can be translated by the team per billing period.

Request

JavaScriptCurl

const response = await fetch('https://api.deepl.com/v2/usage', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{}