Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

MicrosoftTranslator Build Status

Ruby wrapper for Microsoft Translate HTTP API.

Still a work-in-progress. Currently only supports translating one string of text at a time.


Before translating things from your ruby application you first need to sign up for the Microsoft Translator API in the Windows Azure Datamarket.

Don't worry, they have a free tier! (up to 2 million translated characters/month) Once you sign up for the Translator API you will also need to register your application with the Azure Datamarket.

Also, you shouldn't stress about what to put for the Redirect URI. For the purposes of this gem you won't be using it so your project's homepage will work just fine. You'll use the Client ID and Client secret to authenticate your requests to the API. Once this is done you'll install it like you would any other gem...

Add this line to your application's Gemfile:

gem 'microsoft_translator'

And then execute:

$ bundle

Or install it yourself as:

$ gem install microsoft_translator


Create a MicrosoftTranslator::Client with your Client ID & secret.

translator ='your_client_id', 'your_client_secret')


To translate pass in the foreign text along with the language codes for the language you are going from/to and the content type. The content type is either "text/plain" or "text/html"

spanish = "hasta luego muchacha"
   # =>  "until then girl"

Language Detection

To detect the language simply pass in the foreign text. The language code will be returned.

translator.detect("Quiero un burrito")
   # =>  "es"

That's about it! This is a list of the supported languages by the Microsoft Translate API and here are all the language codes as a helpful reference.


There are still quiet a few other methods available in the API that need to be covered.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Ruby client for the microsoft translator API




You can’t perform that action at this time.