docs / translate
Translate API
Translate API
base /translate/v15 endpoints
post
/translate/v1/translate1 creditTranslate text into a single target language. Auto-detects the source by default and returns the detected language + confidence. Supports every script.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| text | required | — | The text to translate. Plain UTF-8 — any script works (Latin, Chinese, Japanese, Arabic, Cyrillic…). Up to 5000 characters per call; longer input is truncated and flagged in meta.truncated. |
| target | required | af · sq · am · ar · hy · as · ay · az · bm · eu · be · bn · bho · bs · bg · ca · ceb · ny · zh-CN · zh-TW · co · hr · cs · da · dv · doi · nl · en · eo · et · ee · tl · fi · fr · fy · gl · ka · de · el · gn · gu · ht · ha · haw · iw · hi · hmn · hu · is · ig · ilo · id · ga · it · ja · jw · kn · kk · km · rw · gom · ko · kri · ku · ckb · ky · lo · la · lv · ln · lt · lg · lb · mk · mai · mg · ms · ml · mt · mi · mr · mni-Mtei · lus · mn · my · ne · no · or · om · ps · fa · pl · pt · pa · qu · ro · ru · sm · sa · gd · nso · sr · st · sn · sd · si · sk · sl · so · es · su · sw · sv · tg · ta · tt · te · th · ti · ts · tr · tk · ak · uk · ur · ug · uz · vi · cy · xh · yi · yo · zu | Target language code to translate INTO (e.g. 'es', 'fr', 'ja', 'ar'). Must be one of the supported codes (see the 'languages' action). Friendly aliases like 'zh' or 'he' are accepted. |
| source = auto | optional | — | Source language code (ISO-639-style, e.g. 'en', 'de', 'zh-CN'). Defaults to 'auto' — the language is detected automatically and returned as detected_source. See the 'languages' action for codes. |
post
/translate/v1/translate_multi1 creditTranslate the SAME text into MANY target languages in a single call — the multi-target differentiator. Pass up to 60 target codes; returns a translation for each, fanned out concurrently (≈15× faster than calling translate per language).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| text | required | — | The text to translate. Plain UTF-8 — any script works (Latin, Chinese, Japanese, Arabic, Cyrillic…). Up to 5000 characters per call; longer input is truncated and flagged in meta.truncated. |
| targets | required | — | List of target language codes to translate the SAME text into, in ONE call (e.g. ['es','fr','de','ja','ar']). Accepts a JSON array or a comma-separated string. Up to 60 targets; unknown codes are rejected (never silently skipped). |
| source = auto | optional | — | Source language code (ISO-639-style, e.g. 'en', 'de', 'zh-CN'). Defaults to 'auto' — the language is detected automatically and returned as detected_source. See the 'languages' action for codes. |
post
/translate/v1/detect1 creditDetect the language of a piece of text. Returns the detected language code, its name and a confidence score (0-1). Works on any script.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| text | required | — | The text to translate. Plain UTF-8 — any script works (Latin, Chinese, Japanese, Arabic, Cyrillic…). Up to 5000 characters per call; longer input is truncated and flagged in meta.truncated. |
post
/translate/v1/dictionary1 creditWord-level dictionary lookup: translate a word/short phrase and get its meanings grouped by part of speech, synonyms, back-translations and transliteration (romanization). Best for single words or short phrases.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| text | required | — | A word or short phrase to look up. |
| target | required | af · sq · am · ar · hy · as · ay · az · bm · eu · be · bn · bho · bs · bg · ca · ceb · ny · zh-CN · zh-TW · co · hr · cs · da · dv · doi · nl · en · eo · et · ee · tl · fi · fr · fy · gl · ka · de · el · gn · gu · ht · ha · haw · iw · hi · hmn · hu · is · ig · ilo · id · ga · it · ja · jw · kn · kk · km · rw · gom · ko · kri · ku · ckb · ky · lo · la · lv · ln · lt · lg · lb · mk · mai · mg · ms · ml · mt · mi · mr · mni-Mtei · lus · mn · my · ne · no · or · om · ps · fa · pl · pt · pa · qu · ro · ru · sm · sa · gd · nso · sr · st · sn · sd · si · sk · sl · so · es · su · sw · sv · tg · ta · tt · te · th · ti · ts · tr · tk · ak · uk · ur · ug · uz · vi · cy · xh · yi · yo · zu | Target language code to translate INTO (e.g. 'es', 'fr', 'ja', 'ar'). Must be one of the supported codes (see the 'languages' action). Friendly aliases like 'zh' or 'he' are accepted. |
| source = auto | optional | — | Source language code (ISO-639-style, e.g. 'en', 'de', 'zh-CN'). Defaults to 'auto' — the language is detected automatically and returned as detected_source. See the 'languages' action for codes. |
post
/translate/v1/languagesfreeList all supported languages (code → English name). Useful to populate a language picker or validate a code before translating.
Try in playground →Example request · translate
curl -X POST https://api.reefapi.com/translate/v1/translate \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"text":"Hello, how are you?","target":"es"}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}