Documentation

Table of Contents

Supported LanguagesAPIUpload/Download

Supported Languages (103)

LanguageSymbolTop 9Top 48
English (English)enXX
Afrikaans (Afrikaans)af
Albanian (shqiptar)sq
Amharic (አማርኛ)am
Arabic (عربى)arXX
Armenian (հայերեն)hy
Azerbaijani (Azərbaycan)az
Basque (Euskal)eu
Belarusian (беларускі)be
Bengali (বাঙালি)bnX
Bosnian (Bosanski)bs
Bulgarian (български)bgX
Catalan (Català)caX
Cebuano (Cebuano)ceb
Chichewa (Chichewa)ny
Chinese Simplified (简体中文)zh-cnX
Chinese Traditional (中國傳統的)zh-twX
Corsican (Corsu)co
Croatian (Hrvatski)hrX
Czech (čeština)csX
Danish (dansk)daX
Dutch (Nederlands)nlXX
Esperanto (Esperanto)eoX
Estonian (Eesti keel)etX
Filipino (Filipino)tlX
Finnish (Suomalainen)fiX
French (français)frXX
Frisian (Frysk)fy
Galician (Galego)gl
Georgian (ქართული)ka
German (Deutsche)deXX
Greek (Ελληνικά)elX
Gujarati (ગુજરાતી)gu
Haitian Creole (Kreyòl Ayisyen)ht
Hausa (Hausa)ha
Hawaiian (Ōlelo Hawaiʻi)haw
Hebrew (עברית)iwX
Hindi (हिंदी)hiX
Hmong (Hmoob)hmn
Hungarian (Magyar)huX
Icelandic (Íslensku)is
Igbo (Igbo)ig
Indonesian (bahasa Indonesia)idX
Irish (Gaeilge)ga
Italian (italiano)itXX
Japanese (日本人)jaXX
Javanese (Wong Jawa)jw
Kannada (ಕನ್ನಡ)kn
Kazakh (Қазақша)kk
Khmer (ភាសាខ្មែរ)km
Korean (한국어)koX
Kurdish (Kurmanji)ku
Kyrgyz (Кыргызча)ky
Lao (ລາວ)lo
Latin (Latine)la
Latvian (Latviešu valoda)lvX
Lithuanian (Lietuvių)ltX
Luxembourgish (Lëtzebuergesch)lb
Macedonian (Македонски)mk
Malagasy (Malagasy)mg
Malay (Melayu)msX
Malayalam (മലയാളം)mlX
Maltese (Malti)mt
Maori (Maori)mi
Marathi (मराठी)mrX
Mongolian (Монгол хэл)mn
Myanmar (မြန်မာ (ဗမာ))my
Nepali (नेपाली)ne
Norwegian (norsk)noX
Pashto (پښتو)ps
Persian (فارسی)fa
Polish (Polskie)plX
Portuguese (Português)ptX
Romanian (Română)roX
Russian (русский)ruXX
Samoan (Samoa)sm
Scots Gaelic (Gàidhlig na h-Alba)gd
Serbian (Српски)srX
Sesotho (Sesotho)st
Shona (Shona)sn
Sindhi (سنڌي)sd
Sinhala (සිංහල)si
Slovak (slovenský)skX
Slovenian (Slovenščina)slX
Somali (Somali)so
Spanish (Español)esXX
Sundanese (Sunda)su
Swahili (Kiswahili)sw
Swedish (svenska)svX
Tajik (Тоҷикӣ)tgX
Tamil (தமிழ்)taX
Telugu (తెలుగు)teX
Thai (ไทย)thX
Turkish (Türk)trX
Ukrainian (Українська)ukX
Urdu (اردو)urX
Uzbek (O'zbek)uz
Vietnamese (Tiếng Việt)viX
Welsh (Cymraeg)cy
Xhosa (isiXhosa)xh
Yiddish (ייִדיש)yi
Yoruba (Yorùbá)yo
Zulu (Zulu)zu

Key Values API

To access the key values in the language of your choosing, you'll use the key values endpoint. The endpoint is located at https://app-translation.com/api/keys and expects a POST request of request type. For examples of making a REST request in NodeJS, Python, Java, or a variety of other languages, we recommend checking out Rapid API's interface at rapidapi.com.

Recommended Usage

It is not recommended to use this API for each production level server response. It is strongly recommended to cache the results of your API request for reuse as a JSON file, a stored variable, etc. This would improve your website response time and reduce the load on its servers. The data this API responds with is unlikely to change.

Request Type

Request Body:

{
  "appId": "appId found in app settings.",
  "secret": "app secret found in app settings.",
  "languageSymbol": "Language symbol of any of the supported languages.",
  "keys": [
    "(OPTIONAL) Array of keys (as strings) you are requesting. If keys are present, tags cannot be."
  ],
  "tags": [
    "(OPTIONAL) Array of tags (as strings) you are requesting. If tags are present, keys cannot be."
  ]
}

Response Type

Three response codes are possible, 200 for successful responses, 400 for errors in body or body data sent, and 500 for internal server errors.

Response Body:

{
  "appId": "appId found in app settings.",
  "language": {
    "language": "Display name such as \"English\" or \"Spanish\" of the language you are requesting.",
    "nativeName": "The native spelling of the language you are requesting, such as \"Español\"",
    "symbol": "The language symbol associated with the language in supported languages."
  },
  "keyValues": [
    {
      "name": "Name of key.",
      "value": "key value in the specified language.",
      "tags": [
        "Array of tags as strings"
      ]
    }
  ]
}


Upload and Download

Upload

The supported uploadable file types are currently JSON and CSV. JSON allows you to upload the tags, pre-existing translations, and any number of keys. The CSV limits uploads to only tags and keys, you cannot upload pre-existing translations using CSV Downloads.

Note, a method to upload markdown (.md) files is currently in the works which will auto tag and auto key the related markdown keys and values.

Download

Download currently supports JSON which has a similar format to the upload option.