DeepL API: Translate text
Translates up to 1,500 characters with DeepL's free web translator, from a named or auto-detected source language into a named target language.
Unofficial. Not affiliated with or endorsed by DeepL.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Text, required
text Text to translate, up to 1,500 characters. Example: Please send the contract by Friday.
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
- Source Language optional
source_language Language of the text, or auto-detect. Example: English.
auto-detect (default)
- Target Language, required
target_language Language for the translation. Example: German.
German
Input as JSON
{ "text": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "target_language": "German"}Output
{ "page_url": "https://www.deepl.com/en/translator" , "source_language": "Wolof", "target_language": "German", "translated_text": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "source_language_code": "wo", "target_language_code": "de-de", "alternative_translations": []}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"deepl.com/translate_text","input":{"text":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","target_language":"German"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "deepl.com/translate_text" , "input": { "text": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "target_language": "German" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "deepl.com/translate_text" , "input": { "text": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "target_language": "German" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run deepl.com/translate_text# with {"text":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","target_language":"German"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "text", "target_language" ], "properties": { "text": { "type": "string", "description": "Text to translate, up to 1,500 characters. Example: Please send the contract by Friday." }, "source_language": { "type": "string", "default": "auto-detect", "description": "Language of the text, or auto-detect. Example: English." }, "target_language": { "type": "string", "description": "Language for the translation. Example: German." } }}Output schema
{ "type": "object", "required": [ "translated_text", "source_language", "target_language", "alternative_translations", "source_language_code", "target_language_code", "page_url" ], "properties": { "page_url": { "type": "string" }, "source_language": { "type": "string" }, "target_language": { "type": "string" }, "translated_text": { "type": "string" }, "source_language_code": { "type": "string", "x-fous-developer": true }, "target_language_code": { "type": "string", "x-fous-developer": true }, "alternative_translations": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
deepl.com/translate_text- Returns
- translated text, source and target language names and codes, whole-text alternatives when shown, page URL
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method deepl.com/translate_text with the inputs above.
Ask your agent
- Translate "Please send the contract by Friday" into German using DeepL
- Use deepl.com to turn this French paragraph into English: "Nous avons bien reçu votre commande et elle sera expédiée demain matin."
- What does "Wo ist der nächste Bahnhof?" mean in Spanish? Give me a couple of alternative phrasings too if any show up.
- I need this customer email in Japanese: "Thank you for your patience. Your refund has been processed and should appear within 5 business days."
- Not sure what language this is, can you detect it and put it into English? "Obrigado pela reunião de ontem, vamos rever a proposta até segunda-feira."
See more
Translates up to 5,000 characters on Google Translate, with the detected source language, Latin-letter pronunciation when shown, and dictionary alternatives for words or short phrases.
translate.google.com/translate_textTranslates a word or phrase between languages using WordReference, including usage notes, example sentences and compound forms when shown. Only language pairs listed by WordReference are available.
wordreference.com/translate_wordTranslates a word between English and a language Cambridge supports. Returns the meanings, the translations and any paired examples.
dictionary.cambridge.org/translate_wordReturns the spoken captions and timed segments of a YouTube video, given a video link or a title (top search match). Only captions the video has are returned.
youtube.com/get_video_transcriptGets the plain text of a public-domain Project Gutenberg book by title, optionally matching its author and language. Chooses the most downloaded matching edition with a plain-text file, removes the Gutenberg header and license, and can cut the text after a chosen number of words.
gutenberg.org/get_book_textReads a public TechCrunch article by link or headline and returns its text, authors, dates, section, tags and image. Live blogs return their latest public updates.
techcrunch.com/read_articleGets a word's Thesaurus.com meanings in site order, with part of speech, short meaning, synonyms and antonyms ranked strongest, strong or weak.
dictionary.com/get_synonymsTests a web page with Google PageSpeed Insights on mobile or desktop: performance, accessibility, best practices and SEO scores, lab timings, real-user Core Web Vitals when available, and the top suggested fixes.
pagespeed.web.dev/check_page_speed