Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A Ruby wrapper for the Bing API
branch: master
Failed to load latest commit information.
lib We aren't actually using the Hashie::HashExtensions (#to_mash or #str…
spec Add adult filter options, aliased as safe_search because MSFT's optio…
.document Add History document to project
Gemfile Binged works fine with current versions of Hashie
HISTORY Updated history for upcoming release
LICENSE Update license year to 2010 Matz is now safe for work.
Rakefile Reinstate task :default => :spec
VERSION Version bump to 0.3.0
binged.gemspec Binged works fine with current versions of Hashie


About Binged

A Ruby wrapper for the Bing API. DSL inspired by jnunemaker's Twitter Gem Search API wrapper.


[sudo] gem install binged

Get Your Bing API key

To use binged, you will require a Bing API key. Create one at:


Instantiate a client

binged = => 'binged')

Ruby on Rails

Binged allows for configuration to be done once using a configure block. To use binged in your Ruby on Rails project, configure it globally in an initializer.

# config/initializers/binged.rb
Binged.configure do |config|
  config.api_key = 'api_key'

# Client initialization
binged =            

Web Search Example

# Find 30 results for ruby from site
web_search =
web_search.containing('ruby').from_site('').per_page(30).each {|result| pp result }

Image Search Example

# Find all portrait Matz images with a wide aspect ratio
image_search =
image_search.containing('Yukihiro Matsumoto').portrait.safe_search(:strict).wide.each {|image| pp image}

Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


Copyright (c) 2010 Kevin Faustino. See LICENSE for details.

Something went wrong with that request. Please try again.