Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Gem that retrieves review information from different services
branch: master

no activesupport dependency

latest commit 6f982e0b31
Jinru Wu & Lihan Li authored


Build Status

Is a simple api wrapper for:

  • Yelp
  • Citysearch
  • Google Ratings

Getting started

Add this line to your application's Gemfile:

gem 'user_reviews'

And then execute:

$ bundle

Or install it yourself as:

$ gem install user_reviews


Create an api_provider

For Citysearch

auth_info = {publisher_key: 'your_city_search_api_key'}
city_search = UserReviews.provider_factory(:citysearch, auth_info)

For Google Reviews

auth_info = {key: 'your_google_api_key'}
google = UserReviews.provider_factory(:google, auth_info)

For Yelp

auth_info = {consumer_key: 'yelp_consumer_key', consumer_secret:'yelp_consumer_secret' ,token:'yelp_token' , token_secret:'yelp_token_secret'}
yelp = UserReviews.provider_factory(:yelp, auth_info)

Get reviews for a business

city_search.find_reviews_for_business city_search_business_id

Get information about a business


Each Review object has 4 attributes:

  • author_name
  • rating
  • reviewed_at
  • comment

Each Business object has 4 attributes:

  • name
  • address
  • reference
  • average_rating
  • url

More information about each API:


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Add your own provider folder which inherits from the Providers::Base class and tests
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request


MIT License. Copyright 2013.

Something went wrong with that request. Please try again.