Braille translator API gives you API access to braille translator, so that you can integrate this functionality in your websites or applications.
To access the web version of the translator click here.
https://api.funtranslations.com/translate/
Our translation API is public. To maintain our service level we ratelimit the number of API calls. For public API calls this is 60 API calls a day with distribution of 5 calls an hour. For paid plans this limit is increased according to the service level described in the plan.
For public calls you don't need to pass any API key. Just invoke the endpoint (see examples below). For paid subscriptions you need to pass the API key.
Currently we support API Key based authentication. Please set a request header 'X-FunTranslations-Api-Secret' with value of your API key. Alternatively you can also pass api_key= as a request parameter, though we strongly discourage this mode of passing the key.
To translate from English to braille use the following API.
Translate from English to braille.
ParametersParameter Name | Parameter Type | Description |
---|---|---|
text | string | Text to translate. |
Here is the full url to use.
https://api.funtranslations.com/translate/braille.json
Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.
Here is an example using CURL to convert the given text.
curl -v -i -X POST -H 'X-Funtranslations-Api-Secret: <api_key>' -d "text=Fun Translations has something for everyone." https://api.funtranslations.com/translate/braille.json
The above call if successful will return a json response something like this.
{ "success": { "total": 1 }, "contents": { "translated": "Array", "text": "Fun Translations has something for everyone.", "translation": "braille" } }
To translate from English to braille use the following API. This is what you use if you have a braille display. This API translates the English text into characters that a braille display understands and you can feed the translated text directly to the display.
Translate from English to braille.
ParametersParameter Name | Parameter Type | Description |
---|---|---|
text | string | Text to translate. |
Here is the full url to use.
https://api.funtranslations.com/translate/braille.json
Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.
https://api.funtranslations.com/translate/braille.json?text=Fun%20Translations%20has%20something%20for%20everyone.Here is an example using CURL to convert the given text.
curl -v -i -X POST -H 'X-Funtranslations-Api-Secret: <api_key>' -d "text=Fun Translations has something for everyone." https://api.funtranslations.com/translate/braille.json
The above call if successful will return a json response something like this.
{ "success": { "total": 1 }, "contents": { "translated": " ,fun ,transl,ns has \"s?+ =\r\n\"ey\"o4\r\n", "text": "Fun Translations has something for everyone.", "translation": { "source": "english", "destination": "braille display" } } }
To translate from English to Braille dots use the following API. This is highly educational (to see which dots are enabled) and can potentially drive a non braille display which works on individual dots.
Translate from English to braille dots.
ParametersParameter Name | Parameter Type | Description |
---|---|---|
text | string | Text to translate. |
Here is the full url to use.
https://api.funtranslations.com/translate/braille/dots.json
Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.
https://api.funtranslations.com/translate/braille/dots.json?text=Fun%20Translations%20has%20something%20for%20everyone.Here is an example using CURL to convert the given text.
curl -v -i -X POST -H 'X-Funtranslations-Api-Secret: <api_key>' -d "text=Fun%20Translations%20has%20something%20for%20everyone." https://api.funtranslations.com/translate/braille/dots.json
The above call if successful will return a json response something like this.
{ "success": { "total": 1 }, "contents": { "translated": [ "none", "none", "6", "124", "136", "1345", "none", "6", "2345", "1235", "1", "1345", "234", "123", "6", "1345", "234", "none", "125", "1", "234", "none", "5", "234", "1456", "346", "none", "123456", "\r", "\n", "5", "15", "13456", "5", "135", "256", "\r", "\n" ], "text": "Fun Translations has something for everyone.", "translation": { "source": "english", "destination": "braille dots" } } }
To translate from English to Braille Unicode characters use the following API.
Translate from English to Braille Unicode characters.
ParametersParameter Name | Parameter Type | Description |
---|---|---|
text | string | Text to translate. |
Here is the full url to use.
https://api.funtranslations.com/translate/braille/unicode.json
Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.
https://api.funtranslations.com/translate/braille/unicode.json?text=Fun%20Translations%20has%20something%20for%20everyone.Here is an example using CURL to convert the given text.
curl -v -i -X POST -H 'X-Funtranslations-Api-Secret: <api_key>' -d "text=Fun%20Translations%20has%20something%20for%20everyone." https://api.funtranslations.com/translate/braille/unicode.json
The above call if successful will return a json response something like this.
{ "success": { "total": 1 }, "contents": { "translated": [ "⠀", "⠀", "⠠", "⠋", "⠥", "⠝", "⠀", "⠠", "⠞", "⠗", "⠁", "⠝", "⠎", "⠇", "⠠", "⠝", "⠎", "⠀", "⠓", "⠁", "⠎", "⠀", "⠐", "⠎", "⠹", "⠬", "⠀", "⠿", "\r", "\n", "⠐", "⠑", "⠽", "⠐", "⠕", "⠲", "\r", "\n" ], "text": "Fun Translations has something for everyone.", "translation": { "source": "english", "destination": "braille unicode" } } }
To translate from English to Braille Image characters use the following API. This is probably what you want to use if you are displaying braille in a browser.
Translate from English to Braille image characters.
ParametersParameter Name | Parameter Type | Description |
---|---|---|
text | string | Text to translate. |
Here is the full url to use.
https://api.funtranslations.com/translate/braille/image.json
Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.
https://api.funtranslations.com/translate/braille/image.json?text=Fun%20Translations%20has%20something%20for%20everyone.Here is an example using CURL to convert the given text.
curl -v -i -X POST -H 'X-Funtranslations-Api-Secret: <api_key>' -d "text=Fun%20Translations%20has%20something%20for%20everyone." https://api.funtranslations.com/translate/braille/image.json
The above call if successful will return a json response something like this.
{ "success": { "total": 1 }, "contents": { "translated": [ "<img src='https://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = ⠀' title='char 0x2800 = ⠀' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = ⠀' title='char 0x2800 = ⠀' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/20.gif' alt='char 0x2820 = ⠠' title='char 0x2820 = ⠠' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/0b.gif' alt='char 0x280b = ⠋' title='char 0x280b = ⠋' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/25.gif' alt='char 0x2825 = ⠥' title='char 0x2825 = ⠥' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/1d.gif' alt='char 0x281d = ⠝' title='char 0x281d = ⠝' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = ⠀' title='char 0x2800 = ⠀' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/20.gif' alt='char 0x2820 = ⠠' title='char 0x2820 = ⠠' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/1e.gif' alt='char 0x281e = ⠞' title='char 0x281e = ⠞' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/17.gif' alt='char 0x2817 = ⠗' title='char 0x2817 = ⠗' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/01.gif' alt='char 0x2801 = ⠁' title='char 0x2801 = ⠁' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/1d.gif' alt='char 0x281d = ⠝' title='char 0x281d = ⠝' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = ⠎' title='char 0x280e = ⠎' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/07.gif' alt='char 0x2807 = ⠇' title='char 0x2807 = ⠇' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/20.gif' alt='char 0x2820 = ⠠' title='char 0x2820 = ⠠' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/1d.gif' alt='char 0x281d = ⠝' title='char 0x281d = ⠝' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = ⠎' title='char 0x280e = ⠎' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = ⠀' title='char 0x2800 = ⠀' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/13.gif' alt='char 0x2813 = ⠓' title='char 0x2813 = ⠓' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/01.gif' alt='char 0x2801 = ⠁' title='char 0x2801 = ⠁' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = ⠎' title='char 0x280e = ⠎' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = ⠀' title='char 0x2800 = ⠀' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/10.gif' alt='char 0x2810 = ⠐' title='char 0x2810 = ⠐' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = ⠎' title='char 0x280e = ⠎' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/39.gif' alt='char 0x2839 = ⠹' title='char 0x2839 = ⠹' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/2c.gif' alt='char 0x282c = ⠬' title='char 0x282c = ⠬' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = ⠀' title='char 0x2800 = ⠀' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/3f.gif' alt='char 0x283f = ⠿' title='char 0x283f = ⠿' class='img-braille-char'>", "\r", "\n", "<img src='https://funtranslations.com/img/braille/char/10.gif' alt='char 0x2810 = ⠐' title='char 0x2810 = ⠐' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/11.gif' alt='char 0x2811 = ⠑' title='char 0x2811 = ⠑' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/3d.gif' alt='char 0x283d = ⠽' title='char 0x283d = ⠽' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/10.gif' alt='char 0x2810 = ⠐' title='char 0x2810 = ⠐' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/15.gif' alt='char 0x2815 = ⠕' title='char 0x2815 = ⠕' class='img-braille-char'>", "<img src='https://funtranslations.com/img/braille/char/32.gif' alt='char 0x2832 = ⠲' title='char 0x2832 = ⠲' class='img-braille-char'>", "\r", "\n" ], "text": "Fun Translations has something for everyone.", "translation": { "source": "english", "destination": "braille images" } } }
To translate from English to Braille Image characters use the following API. This is probably what you want to use if you are displaying braille in a browser.
Translate from English to Braille html characters.
ParametersParameter Name | Parameter Type | Description |
---|---|---|
text | string | Text to translate. |
Here is the full url to use.
https://api.funtranslations.com/translate/braille/html.json
Here is an example using your browser to convert the given text. Click on the below link to get the json response for the text.
https://api.funtranslations.com/translate/braille/html.json?text=Fun%20Translations%20has%20something%20for%20everyone.Here is an example using CURL to convert the given text.
curl -v -i -X POST -H 'X-Funtranslations-Api-Secret: <api_key>' -d "text=Fun%20Translations%20has%20something%20for%20everyone." https://api.funtranslations.com/translate/braille/html.json
The above call if successful will return a json response something like this.
{ "success": { "total": 1 }, "contents": { "translated": [ "⠀", "⠀", "⠠", "⠋", "⠥", "⠝", "⠀", "⠠", "⠞", "⠗", "⠁", "⠝", "⠎", "⠇", "⠠", "⠝", "⠎", "⠀", "⠓", "⠁", "⠎", "⠀", "⠐", "⠎", "⠹", "⠬", "⠀", "⠿", "\r", "\n", "⠐", "⠑", "⠽", "⠐", "⠕", "⠲", "\r", "\n" ], "text": "Fun Translations has something for everyone.", "translation": { "source": "english", "destination": "braille html" } } }
1 API Key |
1000 API Calls / day |
Best in class backend tools |
Easy to use REST API |
Immediate provisioning |
1 API Key |
5000 API Calls / day |
Best in class backend tools |
Easy to use REST API |
Immediate provisioning |
1 API Key |
12500 API Calls / day |
Best in class backend tools |
Easy to use REST API |
Immediate provisioning |