RateBeer API

RateBeer allows for JSON interaction for web developers looking to implement dynamic content from RateBeer or mobile applications that allow RateBeer users to better interact with the site via mobile device.

More info on JSON is available here. http://www.json.org/

Please Do Get a developer key, it's now required Share your creations with us. We can help promote them. Provide feedback, especially if you've found a glitch

Please Don't Hammer the site with repeating, recursive or otherwise demanding requests Build a remote database of our copyrighted content Share your developer keys

Beers I've created an updating list of beers with beer name, BeerID and searchable field here: http://www.ratebeer.com/documents/downloads/beers.zip It's recreated automatically every Saturday morning.

Below are the scripts available with instructions for use. If you have any questions or would like a

custom script, please ask! Send me an email joet@ratebeer.com. =================================================================== User remote login http://www.ratebeer.com/Signin_m.asp receives via post... username = user name pwd = password saveinfo = whether to assign a cookie to the browser (bit) redirect = redirection URL at your site to process post log in script will return the user to the above redirect script with the following querystring info uid = RateBeer User ID You can then store the user ID in a cookie or session variable to use with subsequent query requests.

=================================================================

Saving A Beer Rating http://www.ratebeer.com/m/m_saverating.asp post the following... BeerID = bid Aroma = Aroma Appearance = Appearance Taste = Taste Mouthfeel = Mouthfeel Overall = Overall UserID is verified via session variable

---------------------------------------------------------------------------------------------------------------

UPC Search /json/upc.asp Returns top two matches of UPC to Beer. Example: http://www.ratebeer.com/json/upc.asp?upc=636251770128 upc = UPC

--------Best Beers By Country /json/bcc.asp Shows best beers by country. Optional userid shows best you haven't had. u = userid (optional) c = country id ----------------Beers Available At Place /json/beershere.asp get beers at places by place id.. pid = place id

-----------------

PlaceSearch /json/psstring.asp search for places by string. Helps if you send western characters. s = place search string ----------------Get Top Users /json/topusers.asp Returns the top users p = page number r = records per page (30 max) ---------------Get Top Beers /json/tb.asp Top 50 worldwide Top 50 beers by season Top 50 beers by country m = mode. "season", "country" or "top50" u = userID, sent so that a user knows if they've had it or not (for top50 and country only) s= sort type (for top50 only) season = season integer (1-4 for winter through fall for season only) c = countryID (see below bottom for country values for country only) ---------------Beer images are available (when available) from /beerimages/[beerid].jpg ---------------Get Ratings (Reviews) For A Beer /json/gr.asp bid = BeerID uid = UserID (if you wanted to show a rating from a single user) s = sort (optional, defaults to most recent) p = page number (this is optional and designated the page of ratings you'd like to view. 10 per page.)

---------------Get Recent Raves /json/raves.asp no parameters ---------------Get Recent Raves /json/ratpag.asp r = number of records to return (optional, max is 30) no other parameters ---------------New Beers http://ratebeer.com/json/nb.asp?d=10/01/2009&p=1 p = Page Number, integer d = date (format is Microsoft, American) Beer search by beerid http://ratebeer.com/json/bff.asp?bd=12 Beer availability search by beerid http://ratebeer.com/json/where.asp?bd=12 Beer search by string http://ratebeer.com/json/bff.asp?bn=francisco Advanced beer search by string http://ratebeer.com/json/bff.asp?b=franc&u=userid u=UserID Place info by id http://ratebeer.com/json/pss.asp?pid=101 Brewer id search

http://ratebeer.com/json/bss.asp?bd=11 Brewer search by name http://ratebeer.com/json/bss.asp?bn=anchor Beer Places available by Geo http://ratebeer.com/json/beerme.asp?mi=15&ci=Chicago Miles Radius = mi City = ci Latitude = la Longitude = lo

Get My Messages http://ratebeer.com/json/msg.asp?u=12&max=15 u= userid max = max number of messages (< 100)

Show all the Beers by a Brewer http://ratebeer.com/json/bw.asp UserID = u (optional) BrewerID = b Sort = s (optional)

Show me Rate Counts of a User (returns place ratings and beer rating counts) http://ratebeer.com/json/rc.asp?uid=954 UserID = uid

Show me Rate Counts of a Place http://ratebeer.com/json/rc.asp?pid=110 PlaceID = pid Show me Rate Counts of a Beer http://ratebeer.com/json/rc.asp?bid=54 BeerID = bid

Get Brewers list for offline searching

http://www.ratebeer.com/documents/downloads/brewers03032010.csv

List Of Country Codes

<option <option <option <option <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION value=39>Canada</option> value=240>England</option> value=213>United States</option> value=" ">-------------</option> value=1>Afghanistan</OPTION> value=2>Albania</OPTION> value=4>Algeria</OPTION> value=5>American Samoa</OPTION> value=6>Andorra</OPTION> value=7>Angola</OPTION> value=8>Anguilla</OPTION> value=9>Antigua & Barbuda</OPTION> value=10>Argentina</OPTION> value=11>Armenia</OPTION> value=12>Aruba</OPTION> value=13>Ascension Island</OPTION> value=14>Australia</OPTION> value=15>Austria</OPTION> value=16>Azerbaijan</OPTION> value=17>Bahamas</OPTION> value=18>Bahrain</OPTION> value=19>Bangladesh</OPTION> value=20>Barbados</OPTION> value=22>Belarus</OPTION> value=23>Belgium</OPTION> value=24>Belize</OPTION> value=25>Benin</OPTION> value=26>Bermuda</OPTION> value=27>Bhutan</OPTION> value=28>Bolivia</OPTION> value=29>Bosnia</OPTION> value=30>Botswana</OPTION> value=31>Brazil</OPTION> value=32>British Virgin Islands</OPTION> value=33>Brunei</OPTION> value=34>Bulgaria</OPTION> value=35>Burkina Faso</OPTION> value=36>Burundi</OPTION> value=37>Cambodia</OPTION> value=38>Cameroon</OPTION> value=40>Cape Verde Islands</OPTION> value=41>Cayman Islands</OPTION> value=42>Central African Republic</OPTION> value=233>Ceuta</OPTION> value=43>Chad</OPTION>

<OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION

value=44>Chile</OPTION> value=45>China</OPTION> value=46>Christmas Island</OPTION> value=47>Cocos-Keeling Islands</OPTION> value=48>Colombia</OPTION> value=49>Comoros</OPTION> value=50>Congo</OPTION> value=51>Cook Islands</OPTION> value=52>Costa Rica</OPTION> value=53>Croatia</OPTION> value=54>Cuba</OPTION> value=55>Cyprus</OPTION> value=56>Czech Republic</OPTION> value=57>Dem Rep of Congo</OPTION> value=58>Denmark</OPTION> value=59>Diego Garcia</OPTION> value=60>Djibouti</OPTION> value=61>Dominica</OPTION> value=62>Dominican Republic</OPTION> value=236>East Timor</OPTION> value=63>Ecuador</OPTION> value=64>Egypt</OPTION> value=65>El Salvador</OPTION> value=240>England</OPTION> value=66>Equatorial Guinea</OPTION> value=243>Eritrea</OPTION> value=67>Estonia</OPTION> value=68>Ethiopia</OPTION> value=69>Falkland Islands</OPTION> value=244>Faroe Islands</OPTION> value=70>Fiji Islands</OPTION> value=71>Finland</OPTION> value=72>France</OPTION> value=74>French Guiana</OPTION> value=75>French Polynesia</OPTION> value=76>Gabon</OPTION> value=77>Gambia</OPTION> value=78>Georgia</OPTION> value=79>Germany</OPTION> value=80>Ghana</OPTION> value=81>Gibraltar</OPTION> value=82>Greece</OPTION> value=83>Greenland</OPTION> value=84>Grenada</OPTION> value=85>Guadeloupe</OPTION> value=86>Guam</OPTION> value=88>Guatemala</OPTION> value=225>Guernsey</OPTION> value=89>Guinea</OPTION>

<OPTION value=253>Guinea-Bissau</OPTION> <OPTION value=90>Guyana</OPTION> <OPTION value=91>Haiti</OPTION>

<OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION

value=92>Honduras</OPTION> value=93>Hong Kong</OPTION> value=94>Hungary</OPTION> value=95>Iceland</OPTION> value=96>India</OPTION> value=97>Indonesia</OPTION> value=98>Iran</OPTION> value=99>Iraq</OPTION> value=100>Ireland</OPTION> value=224>Isle of Man</OPTION> value=101>Israel</OPTION> value=102>Italy</OPTION> value=103>Ivory Coast</OPTION> value=104>Jamaica</OPTION> value=105>Japan</OPTION> value=226>Jersey</OPTION> value=106>Jordan</OPTION> value=107>Kazakhstan</OPTION> value=108>Kenya</OPTION> value=109>Kiribati Republic</OPTION> value=242>Kosovo</OPTION> value=112>Kuwait</OPTION> value=113>Kyrgyz Republic</OPTION> value=114>Laos</OPTION> value=115>Latvia</OPTION> value=116>Lebanon</OPTION> value=117>Lesotho</OPTION> value=118>Liberia</OPTION> value=119>Libya</OPTION> value=120>Liechtenstein</OPTION> value=121>Lithuania</OPTION> value=122>Luxembourg</OPTION> value=123>Macau</OPTION> value=229>Macedonia</OPTION> value=124>Madagascar</OPTION> value=125>Malawi</OPTION> value=126>Malaysia</OPTION> value=127>Maldives</OPTION> value=128>Mali</OPTION> value=129>Malta</OPTION> value=130>Marshall Islands</OPTION> value=131>Martinique</OPTION> value=230>Mauritius</OPTION> value=132>Mayotte Island</OPTION> value=133>Mexico</OPTION> value=247>Micronesia</OPTION> value=134>Moldova</OPTION> value=135>Monaco</OPTION> value=136>Mongolia</OPTION> value=137>Monserrat</OPTION> value=234>Montenegro</OPTION>

<OPTION value=138>Morocco</OPTION>

<OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION

value=139>Mozambique</OPTION> value=140>Myanmar</OPTION> value=141>Namibia</OPTION> value=142>Nauru</OPTION> value=143>Nepal</OPTION> value=144>Netherlands</OPTION> value=145>Netherlands Antilles</OPTION> value=147>New Caledonia</OPTION> value=148>New Zealand</OPTION> value=149>Nicaragua</OPTION> value=150>Niger</OPTION> value=151>Nigeria</OPTION> value=152>Niue</OPTION> value=153>Norfolk Island</OPTION> value=110>North Korea</OPTION> value=238>Northern Ireland</OPTION> value=255>Northern Marianas</OPTION> value=154>Norway</OPTION> value=155>Oman</OPTION> value=156>Pakistan</OPTION> value=157>Palau</OPTION> value=235>Palestine</OPTION> value=158>Panama</OPTION> value=159>Papua New Guinea</OPTION> value=160>Paraguay</OPTION> value=161>Peru</OPTION> value=162>Philippines</OPTION> value=163>Poland</OPTION> value=164>Portugal</OPTION> value=165>Puerto Rico</OPTION> value=166>Qatar</OPTION> value=246>Runion</OPTION> value=167>Romania</OPTION> value=169>Russia</OPTION> value=170>Rwanda</OPTION> value=172>Saipan Island</OPTION> value=219>Samoa</OPTION> value=173>San Marino</OPTION> value=254>So Tom & Principe</OPTION> value=174>Saudi Arabia</OPTION> value=241>Scotland</OPTION> value=175>Senegal Republic</OPTION> value=221>Serbia</OPTION> value=245>Seychelles</OPTION> value=176>Sierra Leone</OPTION> value=177>Singapore</OPTION> value=178>Slovak Republic</OPTION> value=179>Slovenia</OPTION> value=180>Solomon Islands</OPTION> value=181>Somalia</OPTION> value=182>South Africa</OPTION> value=111>South Korea</OPTION>

<OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION <OPTION

value=183>Spain</OPTION> value=184>Sri Lanka</OPTION> value=185>St Helena</OPTION> value=186>St Kitts</OPTION> value=171>St Lucia</OPTION> value=227>St Vincent & The Grenadines</OPTION> value=187>Sudan</OPTION> value=188>Suriname</OPTION> value=189>Swaziland</OPTION> value=190>Sweden</OPTION> value=191>Switzerland</OPTION> value=192>Syria</OPTION> value=193>Taiwan</OPTION> value=194>Tajikistan</OPTION> value=195>Tanzania</OPTION> value=196>Thailand</OPTION> value=237>Tibet</OPTION> value=197>Tinian Island</OPTION> value=198>Togo</OPTION> value=199>Tokelau</OPTION> value=200>Tonga</OPTION> value=201>Trinidad & Tobago</OPTION> value=202>Tunisia</OPTION> value=203>Turkey</OPTION> value=204>Turkmenistan</OPTION> value=205>Turks and Caicos Islands</OPTION> value=206>Tuvalu</OPTION> value=207>Uganda</OPTION> value=208>Ukraine</OPTION> value=209>United Arab Emirates</OPTION> value=211>United States Virgin Islands</OPTION> value=212>Uruguay</OPTION> value=214>Uzbekistan</OPTION> value=215>Vanuatu</OPTION> value=216>Vatican City</OPTION> value=217>Venezuela</OPTION> value=218>Vietnam</OPTION> value=239>Wales</OPTION> value=248>Yemen</OPTION> value=222>Zambia</OPTION> value=223>Zimbabwe</OPTION>