Fun Translations Braille API

Fun Translations braille API gives you API access to braille translator.

To access the web version of the translator click here.

API End Points

The end point for connecting : If you subscribe directly from us use this endpoint.
	http://api.funtranslations.com/translate/
	

Ratelimiting

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.

Authentication

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.

Translating English text to braille public ratelimited

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.

POST  /braille

Translate from English to braille.

Parameters
Parameter NameParameter TypeDescription
textstringText to translate.
output
The result is a json object with the converted text.

Here is the full url to use.

	http://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.

http://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." http://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"
        }
    }
}
	

Translating English to Braille Dots public ratelimited

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.

POST  /braille/dots

Translate from English to braille dots.

Parameters
Parameter NameParameter TypeDescription
textstringText to translate.
output
The result is a json object with the converted text.

Here is the full url to use.

	http://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.

http://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." http://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"
        }
    }
}
	

Translating English to Braille unicode public ratelimited

To translate from English to Braille Unicode characters use the following API.

POST  /braille/unicode

Translate from English to Braille Unicode characters.

Parameters
Parameter NameParameter TypeDescription
textstringText to translate.
output
The result is a json object with the converted text in Braille Unicode characters.

Here is the full url to use.

	http://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.

http://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." http://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"
        }
    }
}
	

Translating English to Braille image public ratelimited

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.

POST  /braille/image

Translate from English to Braille image characters.

Parameters
Parameter NameParameter TypeDescription
textstringText to translate.
output
The result is a json object with the converted text in Braille image characters.

Here is the full url to use.

	http://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.

http://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." http://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='http://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = &#x2800;' title='char 0x2800 = &#x2800;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = &#x2800;' title='char 0x2800 = &#x2800;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/20.gif' alt='char 0x2820 = &#x2820;' title='char 0x2820 = &#x2820;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/0b.gif' alt='char 0x280b = &#x280b;' title='char 0x280b = &#x280b;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/25.gif' alt='char 0x2825 = &#x2825;' title='char 0x2825 = &#x2825;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/1d.gif' alt='char 0x281d = &#x281d;' title='char 0x281d = &#x281d;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = &#x2800;' title='char 0x2800 = &#x2800;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/20.gif' alt='char 0x2820 = &#x2820;' title='char 0x2820 = &#x2820;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/1e.gif' alt='char 0x281e = &#x281e;' title='char 0x281e = &#x281e;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/17.gif' alt='char 0x2817 = &#x2817;' title='char 0x2817 = &#x2817;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/01.gif' alt='char 0x2801 = &#x2801;' title='char 0x2801 = &#x2801;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/1d.gif' alt='char 0x281d = &#x281d;' title='char 0x281d = &#x281d;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = &#x280e;' title='char 0x280e = &#x280e;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/07.gif' alt='char 0x2807 = &#x2807;' title='char 0x2807 = &#x2807;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/20.gif' alt='char 0x2820 = &#x2820;' title='char 0x2820 = &#x2820;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/1d.gif' alt='char 0x281d = &#x281d;' title='char 0x281d = &#x281d;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = &#x280e;' title='char 0x280e = &#x280e;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = &#x2800;' title='char 0x2800 = &#x2800;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/13.gif' alt='char 0x2813 = &#x2813;' title='char 0x2813 = &#x2813;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/01.gif' alt='char 0x2801 = &#x2801;' title='char 0x2801 = &#x2801;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = &#x280e;' title='char 0x280e = &#x280e;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = &#x2800;' title='char 0x2800 = &#x2800;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/10.gif' alt='char 0x2810 = &#x2810;' title='char 0x2810 = &#x2810;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/0e.gif' alt='char 0x280e = &#x280e;' title='char 0x280e = &#x280e;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/39.gif' alt='char 0x2839 = &#x2839;' title='char 0x2839 = &#x2839;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/2c.gif' alt='char 0x282c = &#x282c;' title='char 0x282c = &#x282c;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/00.gif' alt='char 0x2800 = &#x2800;' title='char 0x2800 = &#x2800;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/3f.gif' alt='char 0x283f = &#x283f;' title='char 0x283f = &#x283f;' class='img-braille-char'>",
            "\r",
            "\n",
            "<img src='http://funtranslations.com/img/braille/char/10.gif' alt='char 0x2810 = &#x2810;' title='char 0x2810 = &#x2810;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/11.gif' alt='char 0x2811 = &#x2811;' title='char 0x2811 = &#x2811;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/3d.gif' alt='char 0x283d = &#x283d;' title='char 0x283d = &#x283d;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/10.gif' alt='char 0x2810 = &#x2810;' title='char 0x2810 = &#x2810;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/15.gif' alt='char 0x2815 = &#x2815;' title='char 0x2815 = &#x2815;' class='img-braille-char'>",
            "<img src='http://funtranslations.com/img/braille/char/32.gif' alt='char 0x2832 = &#x2832;' title='char 0x2832 = &#x2832;' class='img-braille-char'>",
            "\r",
            "\n"
        ],
        "text": "Fun Translations has something for everyone.",
        "translation": {
            "source": "english",
            "destination": "braille images"
        }
    }
}
	

Translating English to Braille Unicode html public ratelimited

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.

POST  /braille/html

Translate from English to Braille html characters.

Parameters
Parameter NameParameter TypeDescription
textstringText to translate.
output
The result is a json object with the converted text in Braille Unicode html characters.

Here is the full url to use.

	http://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.

http://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." http://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": [
            "&#x2800;",
            "&#x2800;",
            "&#x2820;",
            "&#x280b;",
            "&#x2825;",
            "&#x281d;",
            "&#x2800;",
            "&#x2820;",
            "&#x281e;",
            "&#x2817;",
            "&#x2801;",
            "&#x281d;",
            "&#x280e;",
            "&#x2807;",
            "&#x2820;",
            "&#x281d;",
            "&#x280e;",
            "&#x2800;",
            "&#x2813;",
            "&#x2801;",
            "&#x280e;",
            "&#x2800;",
            "&#x2810;",
            "&#x280e;",
            "&#x2839;",
            "&#x282c;",
            "&#x2800;",
            "&#x283f;",
            "\r",
            "\n",
            "&#x2810;",
            "&#x2811;",
            "&#x283d;",
            "&#x2810;",
            "&#x2815;",
            "&#x2832;",
            "\r",
            "\n"
        ],
        "text": "Fun Translations has something for everyone.",
        "translation": {
            "source": "english",
            "destination": "braille html"
        }
    }
}
	

Subscribe

Fun Translations Braille API Basic

$9.99/mo

No contracts. Anytime cancellation.
1 API Key
1000 API Calls / day
Best in class backend tools
Easy to use REST API
Immediate provisioning

Fun Translations Braille API Premium

$24.99/mo

No contracts. Anytime cancellation.
1 API Key
5000 API Calls / day
Best in class backend tools
Easy to use REST API
Immediate provisioning

Fun Translations Braille API Ultra

$49.99/mo

No contracts. Anytime cancellation.
1 API Key
12500 API Calls / day
Best in class backend tools
Easy to use REST API
Immediate provisioning