Request text improvement Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://bump.sh/polo/hub/about-mcp/doc/deepl/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Deepl MCP server": {
    "url": "https://bump.sh/polo/hub/about-mcp/doc/deepl/mcp"
  }
}
Close
POST /v2/write/rephrase
Auth header

Body Required

  • text array[string] Required

    Text to be improved. Only UTF-8-encoded plain text is supported. Improvements are returned in the same order as they are requested.

  • target_lang string

    The language for the text improvement. Options currently available:

    • de - German
    • en - English (unspecified variant, defaults to en-US)
    • en-GB - English (British)
    • en-US - English (American)
    • es - Spanish
    • fr - French
    • it - Italian
    • pt - Portuguese (unspecified variant, defaults to pt-PT)
    • pt-BR - Portuguese (Brazilian)
    • pt-PT - Portuguese (all Portuguese variants excluding Brazilian Portuguese)

    Values are de, en, en-GB, en-US, fr, it, pt, pt-BR, or pt-PT.

  • writing_style string

    Specify a style to rephrase your text in a way that fits your audience and goals. The prefer_ prefix allows falling back to the default style if the language does not yet support styles.

    Values are academic, business, casual, default, simple, prefer_academic, prefer_business, prefer_casual, or prefer_simple.

  • tone string

    Specify the desired tone for your text. The prefer_ prefix allows falling back to the default tone if the language does not yet support tones.

    Values are confident, default, diplomatic, enthusiastic, friendly, prefer_confident, prefer_diplomatic, prefer_enthusiastic, or prefer_friendly.

Body Required

  • text array[string] Required

    Text to be improved. Only UTF-8-encoded plain text is supported. Improvements are returned in the same order as they are requested.

  • target_lang string

    The language for the text improvement. Options currently available:

    • de - German
    • en - English (unspecified variant, defaults to en-US)
    • en-GB - English (British)
    • en-US - English (American)
    • es - Spanish
    • fr - French
    • it - Italian
    • pt - Portuguese (unspecified variant, defaults to pt-PT)
    • pt-BR - Portuguese (Brazilian)
    • pt-PT - Portuguese (all Portuguese variants excluding Brazilian Portuguese)

    Values are de, en, en-GB, en-US, fr, it, pt, pt-BR, or pt-PT.

  • writing_style string

    Specify a style to rephrase your text in a way that fits your audience and goals. The prefer_ prefix allows falling back to the default style if the language does not yet support styles.

    Values are academic, business, casual, default, simple, prefer_academic, prefer_business, prefer_casual, or prefer_simple.

  • tone string

    Specify the desired tone for your text. The prefer_ prefix allows falling back to the default tone if the language does not yet support tones.

    Values are confident, default, diplomatic, enthusiastic, friendly, prefer_confident, prefer_diplomatic, prefer_enthusiastic, or prefer_friendly.

Responses

  • 200 application/json

    Successful text improvement.

    Hide headers attribute Show headers attribute
    • X-Trace-ID

      A unique identifier for the request that can be included in bug reports to DeepL support.

    Hide response attribute Show response attribute object
    • improvements array[object]

      At least 1 element.

      Hide improvements attributes Show improvements attributes object
      • detected_source_language string

        The language detected in the source text.

      • text string

        The improved text.
POST /v2/write/rephrase 
curl \
 --request POST 'https://api.deepl.com/v2/write/rephrase' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"text":["this is a example sentence to imprve"],"target_lang":"de","writing_style":"academic","tone":"confident"}'
curl \
 --request POST 'https://api.deepl.com/v2/write/rephrase' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'text=this+is+a+example+sentence+to+imprve&target_lang=de&writing_style=academic&tone=confident'
Request examples 
{
  "text": [
    "this is a example sentence to imprve"
  ],
  "target_lang": "de",
  "writing_style": "academic",
  "tone": "confident"
}
Response examples (200) 
# Headers

# Payload
{
  "improvements": [
    {
      "detected_source_language": "en",
      "text": "This is a sample sentence to improve."
    }
  ]
}