Google Translate API: Translate text (v1)

Translates up to 30,000 characters into the target language in one call, detecting the source language when it is not given. Returns the translation, the source language with the detector's confidence, and a Latin-script transliteration for languages written in other scripts.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

text*string

The text to translate, up to 30,000 characters. Line breaks are kept.

Length1 <= length <= 30000

target*string

The language to translate into. A language code such as fr, pt-PT or zh-CN, or an English name such as French, Portuguese (Portugal) or Chinese. Common ISO codes (he, jv, fil, zh) are accepted too. The Languages endpoint lists every one; other values are rejected.

Length1 <= length <= 40

source?string

The language of text. Omit, or pass auto, to detect it. A language code such as fr, pt-PT or zh-CN, or an English name such as French, Portuguese (Portugal) or Chinese. Common ISO codes (he, jv, fil, zh) are accepted too. The Languages endpoint lists every one; other values are rejected.

Length1 <= length <= 40

Default"auto"

curl -X POST "https://example.com/v1/google-translate/translate" \  -H "x-api-key: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "text": "Good morning, how are you?\\nSee you tomorrow.",    "target": "French"  }'

{  "data": {    "translated_text": "Bonjour, comment vas-tu ?\nÀ demain.",    "source_language": "en",    "source_language_name": "English",    "target_language": "fr",    "target_language_name": "French",    "detected": true,    "confidence": 1,    "transliteration": "Kōhī o ippai onegaishimasu.",    "source_transliteration": "Privet, kak dela?",    "characters": 44  },  "details": {    "reason": "string",    "message": "string"  }}