Beer Advocate API is an unofficial JavaScript library for working with http://beeradvocate.com data.
Beer Advocate API can be installed via NPM. (For more on NPM, see this introduction). Make sure you’re in your projects directory, and run the following:
$ npm install beer-advocate-api
Next, make sure to include Beer Advocate API in your project.
var ba = require('beer-advocate-api');
See the online docs here.
Search for a beer
ba.beerSearch("Anchor Steam", function(beers) {
console.log(beers);
});
Example response
[
{
"beer_name": "Anchor Steam Beer",
"beer_url": "/beer/profile/28/63/",
"brewery_name": "Anchor Brewing Company",
"brewery_location": "San Francisco, California",
"brewery_url": "/beer/profile/28/",
"retired": false
},
{
"beer_name": "Drop Anchor Steam Beer",
"beer_url": "/beer/profile/952/9899/",
"brewery_name": "Great Dane Pub & Brewing Company (Downtown)",
"brewery_location": "Madison, Wisconsin",
"brewery_url": "/beer/profile/952/",
"retired": true
},
{
"beer_name": "Anchor's Away Steam Beer",
"beer_url": "/beer/profile/1313/23018/",
"brewery_name": "Lucky Labrador Brewing Company",
"brewery_location": "Portland, Oregon",
"brewery_url": "/beer/profile/1313/",
"retired": true
},
{
"beer_name": "Dry Hopped Steam Beer",
"beer_url": "/beer/profile/28/129664/",
"brewery_name": "Anchor Brewing Company",
"brewery_location": "San Francisco, California",
"brewery_url": "/beer/profile/28/",
"retired": false
}
]
Get a specific beer page
ba.beerPage("/beer/profile/29223/84343/", function(beer) {
console.log(beer);
});
Example response
[
{
"beer_name": "Furious",
"beer_style": "",
"beer_abv": "6.20%",
"brewery_name": "Surly Brewing Company",
"brewery_state": "",
"brewery_country": "",
"ba_score": "96",
"ba_rating": "world-class",
"bros_score": "-",
"bros_rating": "no score",
"ratings": "4,021",
"reviews": "1,379",
"rAvg": "4.33",
"pDev": "9.24%"
}
]
Get a specific beer’s reviews from top reviewers
ba.beerTopReviews("/beer/profile/29223/84343/", 1, function(reviews) {
console.log(reviews);
});
Example response
[
{
"reviewer": "Sammy",
"reviewer_url": "/community/members/sammy.3853/",
"rating": "3.95",
"rating_max": "5",
"attributes": {
"look": "4",
"smell": "4",
"taste": "4",
"feel": "3.5",
"overall": "4"
},
"review_text": "Sample review here.",
"serving_type": "can",
"date": "11-28-2012 04:40:39"
}
]
Search for a brewery
ba.brewerySearch("Big Sky Brewing Company", function(brewery) {
console.log(brewery);
});
Example response
[
{
"brewery_name": "Big Sky Brewing Company",
"brewery_url": "/beer/profile/751/",
"brewery_location": "Missoula, Montana"
}
]
Get a specific brewery page
ba.breweryPage("/beer/profile/2137/", function(brewery) {
console.log(brewery);
});
Example response
[
{
"brewery_name": "Big Sky Brewing Company",
"brewery_rating": {
"score": "94",
"text": "outstanding",
"count": "20",
"reviews": "4",
"rAvg": "4.3",
"pDev": "9.53%"
},
"active_beers": "35",
"beer_ratings": "6,837",
"beer_avg": "3.73",
"taps": "0",
"bottles": "0",
"cask": false,
"beer_to_go": true
}
]
Beer Advocate API is not associated with the �Beer Advocate or it’s magazine. �We’re fans. And love what they do.
Beer Advocate API is authored and maintained by Charlie Hield with help from its contributors:
© 2014, Charlie Hield under the MIT License.