# API Docs ## Languages You can use the /languages endpoint to get a list of supported languages. Here is an example: ``` curl -H "Accept: application/json" "https://novatranslate.p.rapidapi.com/api/v1/languages" ``` A successful response from the API should look like this: ``` { "success": true, "languages": [ { "code": "af", "name": "Afrikaans" }, { "code": "sq", "name": "Albanian" }, { "code": "am", "name": "Amharic" }, { "code": "ar", "name": "Arabic" }, { "code": "hy", "name": "Armenian" }, { "code": "az", "name": "Azerbaijani" }, { "code": "eu", "name": "Basque" }, { "code": "be", "name": "Belarusian" }, { "code": "bn", "name": "Bengali" }, { "code": "bs", "name": "Bosnian" }, { "code": "bg", "name": "Bulgarian" }, { "code": "ca", "name": "Catalan" }, { "code": "ceb", "name": "Cebuano" }, { "code": "ny", "name": "Chichewa" }, { "code": "zh-cn", "name": "Chinese Simplified" }, { "code": "zh-tw", "name": "Chinese Traditional" }, { "code": "co", "name": "Corsican" }, { "code": "hr", "name": "Croatian" }, { "code": "cs", "name": "Czech" }, { "code": "da", "name": "Danish" }, { "code": "nl", "name": "Dutch" }, { "code": "en", "name": "English" }, { "code": "eo", "name": "Esperanto" }, { "code": "et", "name": "Estonian" }, { "code": "tl", "name": "Filipino" }, { "code": "fi", "name": "Finnish" }, { "code": "fr", "name": "French" }, { "code": "fy", "name": "Frisian" }, { "code": "gl", "name": "Galician" }, { "code": "ka", "name": "Georgian" }, { "code": "de", "name": "German" }, { "code": "el", "name": "Greek" }, { "code": "gu", "name": "Gujarati" }, { "code": "ht", "name": "Haitian Creole" }, { "code": "ha", "name": "Hausa" }, { "code": "haw", "name": "Hawaiian" }, { "code": "iw", "name": "Hebrew" }, { "code": "hi", "name": "Hindi" }, { "code": "hmn", "name": "Hmong" }, { "code": "hu", "name": "Hungarian" }, { "code": "is", "name": "Icelandic" }, { "code": "ig", "name": "Igbo" }, { "code": "id", "name": "Indonesian" }, { "code": "ga", "name": "Irish" }, { "code": "it", "name": "Italian" }, { "code": "ja", "name": "Japanese" }, { "code": "jw", "name": "Javanese" }, { "code": "kn", "name": "Kannada" }, { "code": "kk", "name": "Kazakh" }, { "code": "km", "name": "Khmer" }, { "code": "ko", "name": "Korean" }, { "code": "ku", "name": "Kurdish (Kurmanji)" }, { "code": "ky", "name": "Kyrgyz" }, { "code": "lo", "name": "Lao" }, { "code": "la", "name": "Latin" }, { "code": "lv", "name": "Latvian" }, { "code": "lt", "name": "Lithuanian" }, { "code": "lb", "name": "Luxembourgish" }, { "code": "mk", "name": "Macedonian" }, { "code": "mg", "name": "Malagasy" }, { "code": "ms", "name": "Malay" }, { "code": "ml", "name": "Malayalam" }, { "code": "mt", "name": "Maltese" }, { "code": "mi", "name": "Maori" }, { "code": "mr", "name": "Marathi" }, { "code": "mn", "name": "Mongolian" }, { "code": "my", "name": "Myanmar (Burmese)" }, { "code": "ne", "name": "Nepali" }, { "code": "no", "name": "Norwegian" }, { "code": "ps", "name": "Pashto" }, { "code": "fa", "name": "Persian" }, { "code": "pl", "name": "Polish" }, { "code": "pt", "name": "Portuguese" }, { "code": "ma", "name": "Punjabi" }, { "code": "ro", "name": "Romanian" }, { "code": "ru", "name": "Russian" }, { "code": "sm", "name": "Samoan" }, { "code": "gd", "name": "Scots Gaelic" }, { "code": "sr", "name": "Serbian" }, { "code": "st", "name": "Sesotho" }, { "code": "sn", "name": "Shona" }, { "code": "sd", "name": "Sindhi" }, { "code": "si", "name": "Sinhala" }, { "code": "sk", "name": "Slovak" }, { "code": "sl", "name": "Slovenian" }, { "code": "so", "name": "Somali" }, { "code": "es", "name": "Spanish" }, { "code": "su", "name": "Sundanese" }, { "code": "sw", "name": "Swahili" }, { "code": "sv", "name": "Swedish" }, { "code": "tg", "name": "Tajik" }, { "code": "ta", "name": "Tamil" }, { "code": "te", "name": "Telugu" }, { "code": "th", "name": "Thai" }, { "code": "tr", "name": "Turkish" }, { "code": "uk", "name": "Ukrainian" }, { "code": "ur", "name": "Urdu" }, { "code": "uz", "name": "Uzbek" }, { "code": "vi", "name": "Vietnamese" }, { "code": "cy", "name": "Welsh" }, { "code": "xh", "name": "Xhosa" }, { "code": "yi", "name": "Yiddish" }, { "code": "yo", "name": "Yoruba" }, { "code": "zu", "name": "Zulu" } ] } ``` ## Translate You can use the /translate endpoint to translate a body of text.

Key	Required?	Comment	Example
`text`	Yes	The text to be translated	Hello World
`sourceLang`	Yes	The source language of the text	en
`targetLang`	Yes	The target language the text should be translated to	es

Here is an example: ``` curl -X POST "https://novatranslate.p.rapidapi.com/api/v1/translate" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "text": 'Hello World', "sourceLang": "en", "targetLang": "es" }' ``` A successful response from the API should look like this: ``` { "success": true, "originalText": "Hello World", "translatedText": "Hola Mundo" } ``` ## Errors The API may throw an error in case of a malformed request or due to an internal server error. When this happens, the API will return an appropriate status code as well as an error message. Here is an example erroneous request where the targetLang is not a valid ISO 639 language code: ``` curl -X POST "https://novatranslate.p.rapidapi.com/api/v1/translate" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "text": 'Hello World', "sourceLang": "en", "targetLang": "Dothraki" }' ``` And here is the response from the API: ``` { "success": false, "message": "Invalid target language" } ```