eg. "Cheesecake factory","Pizza","Romantic"    Neighborhood , City, Zip or Address
Restaurant Search API

Overview

The BooRah REST (REpresentational State Transfer) Restaurant Search API returns a list of restaurants for supplied 'name' & 'location' parameters.

name can be:

  • full or partial restaurant name
  • cuisine
  • left empty (this will trigger our system to send the top rated restaurants for the given location).
  • It can also be free form (e.g., pad thai, lobster, italian seafood)
location can be:
  • city, state
  • address
  • Latitude/Longitude
  • zip code
  • Neighborhood
  • Rectangular area bounded defined by south west lat/long & norh east lat/long

Parameters

Parameter Description Sample values
auth Your authorization key, mandatory
name Search term Italian, Samosas, Creme Brulee,
Coupons, Reservations
location Search location Mountain View, CA
444 Castro St, Mountain View, CA
94041
Financial District, San Francisco, CA
q Free form query field. We will attempt to parse out name and location.
Useful for sites that take user input from one text field
Best restaurants San Jose ca
discounts in palo alto
online menus in mountain view, ca
94041 japanese
start Ordinal position of first result. First position is 0. Default sets start to 0. 10
sort Sort specification
distance|buzz, default: distance
Applicable only when searching around address or lat/long
buzz
radius Radius, in miles
Applicable only when searching around address or lat/long
2.4
lat Latitude component of coordinate 37.4419
long Longitude component of coordinate -122.1419
swlat Latitude component of Southwestern corner of rectangle 37.246728019617215
swlong Longitude component of Southwestern corner of rectangle -121.89931869506837
nelat Latitude component of Northeastern corner of rectangle 37.30136768599685
nelong Longitude component of Northeastern corner of rectangle -121.79632186889648

WebService URI

http://api.boorah.com/restaurants/WebServices/RestaurantSearch.do
E.g., http://api.boorah.com/restaurants/WebServices/RestaurantSearch?name=Pad%20Thai&location=94041&auth=your_approved_auth_key

Response

The API returns a XML document as specified by this XSD.
Here's the response for the search term 'Italian Palo Alto'

Request access to API

To request a key, please send us an e-mail with the following details:
  • Your Name
  • Website where your plan to use this service
  • Purpose of use
By default, the maximum number of API requests per day is 5000.
You can review the API Terms and Conditions for restrictions and terms of use.

Technical questions

Please post feedback, questions, complaints in our google groups: BooRah API

Sample Implementation

We implemented this DineFinder using our API and Google Maps.
If the user has Mozilla Geode or Skyhook Loki installed, the tool attempts to determine the initial location automagically.