Translate Text

POST

https://libretranslate.com/translate

Translate Text

curl -X POST 'https://libretranslate.com/translate' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-raw 'q=Hello%20world%21&source=en&target=es&format=text&alternatives=3&api_key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'

const response = await fetch('https://libretranslate.com/translate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: 'q=Hello%20world%21&source=en&target=es&format=text&alternatives=3&api_key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
});

const data = await response.text();

import requests

response = requests.post(
    'https://libretranslate.com/translate',
    data='q=Hello%20world%21&source=en&target=es&format=text&alternatives=3&api_key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'.encode('utf-8'),
    headers={
        'Content-Type': 'application/x-www-form-urlencoded',
    },
)
print(response.text)

Request Body

{
  "q": "Hello world!",
  "source": "en",
  "target": "es",
  "format": "text",
  "alternatives": 3,
  "api_key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

{
  "alternatives": [
    "string"
  ],
  "detectedLanguage": {
    "confidence": 100,
    "language": "string"
  },
  "translatedText": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

Body

application/x-www-form-urlencoded

qstring | Array<any>required

Text(s) to translate

Show child attributes

One of

string

Example

Hello world!

Array<any>

Example

[
  "Hello world!"
]

sourcestringrequired

Source language code or “auto” for auto detection

Example

en

targetstringrequired

Target language code

Example

es

formatstringtexthtmltext

Format of source text:

text - Plain text
html - HTML markup

Example

text

alternativesinteger0

Preferred number of alternative translations

Example

api_keystring

API key

Example

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Response

200OKtranslate

Translation

Response fields application/json

alternativesArray<string> | Array<Array<string>>

Alternative translations

Show child attributes

One of

Array<string>

Array<Array<string>>

detectedLanguageobject | Array<object>

Show child attributes

One of

confidencenumber<float>[0, 100]

Confidence value

Example

languagestring

Language code

Array<object>

Show child attributes

confidencenumber<float>[0, 100]

Confidence value

Example

languagestring

Language code

translatedTextstring | Array<any>required

Translated text(s)

Show child attributes

One of

string

Array<any>

400Bad Requesterror-response

Invalid request

Response fields application/json

errorstring

Error message

403Forbiddenerror-response

Banned

Response fields application/json

errorstring

Error message

429Too Many Requestserror-slow-down

Slow down

Response fields application/json

errorstring

Reason for slow down

500Internal Server Errorerror-response

Translation error

Response fields application/json

errorstring

Error message

Docs by Sourcey