The plugin returns all of the fields available via the RateBeer.com's API (at the time of plugin release). For questions concerning which fields are available via the API queries, please visit RateBeer.com's API Google Group. If new fields are added to the API response, then I can add those fields to the output.
Click the section headers below to view specific fields available for use in your output formats.
Use the output fields as HTML placeholders. For example, if you want to output the name of the beer, then place '#_BEERNAME' in your output format and it will be dynamically replaced with the actual beer name.
Conditions are logical operations such as 'if' statements. For example, if you want to render a beer's ABV, you can use '#_ALCOHOL'. However, if don't want to render the value if it's null/empty, you can use '{has_abv}ABV: #_ALCOHOL %{/has_abv}'. Using that condition, the ABV will only be rendered if it is not null/empty.
Show all the beers by via Beer ID.
Attributes
[beerratings-beer id='1315']
You may also enter multiple beer IDs as shown in the examples below:
[beerratings-beer id='1315,32329']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/bff.asp?k=YOUR_API_KEY&b=1315
{has_abv} | Only render inner text if {has_abv} is true. |
{is_alias} | Only render inner text if {is_alias} is true. |
{is_not_alias} | Only render inner text if {is_not_alias} is true. |
{has_ibu} | Only render inner text if {has_ibu} is true. |
{has_overallpctl} | Only render inner text if {has_overallpctl} is true. |
{has_stylepctl} | Only render inner text if {has_stylepctl} is true. |
{has_description} | Only render inner text if {has_description} is true. |
#_BEERID | The unique identifer associated with the beer. |
#_BEERNAME | The beer's name. |
#_BREWERID | The unique identifer associated with the brewery. |
#_BREWERNAME | The brewery's name. |
#_OVERALLPCTL | The overall percentage represents a beer’s performance relative to all beers on an adjusted percentile basis. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_OVERALLPCTL0. For 1 or 2 places of precision use #_OVERALLPCTL1 or #_OVERALLPCTL2. |
#_STYLEPCTL | The style percentage represents a beer’s performance relative to its peers in the same beer style category on an adjusted percentile basis. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_STYLEPCTL0. For 1 or 2 places of precision use #_STYLEPCTL1 or #_STYLEPCTL2. |
#_BEERSTYLENAME | The beer's style name. |
#_ISALIAS | A boolean indicating whether this is an alias (another name) for a another beer. |
#_ALCOHOL | The beer's alcohol by volume. |
#_IBU | The beer's IBU (International Bitterness Units). |
#_DESCRIPTION | The beer's description. |
#_BEERURL | The URL to the RateBeer.com beer web page. |
#_BEERLINK | A hyperlink to the RateBeer.com beer web page (uses #_BEERURL as href and #_BEERNAME as inner text values). |
#_BEERIMAGEURL | The URL to the RateBeer.com beer image. |
#_BEERIMAGE | An image HTML tag usingthe RateBeer.com beer image (uses #_BEERIMAGE as src and #_BEERNAME as alt values). |
#_BREWERURL | The URL to the RateBeer.com brewer web page. |
#_BREWERLINK | A hyperlink to the RateBeer.com brewer web page (uses #_BREWERURL as href and #_BREWERNAME as inner text values). |
#_BREWERIMAGEURL | The URL to the RateBeer.com brewer image. |
#_BREWERIMAGE | An image HTML tag usingthe RateBeer.com brewer image (uses #_BREWERIMAGE as src and #_BREWERNAME as alt values). |
Show all the beers by a brewer.
Attributes
[beerratings-beer-brewer id='76']
You may also enter multiple brewers IDs as shown in the examples below:
[beerratings-beer-brewer id='76,198,11233']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/bw.asp?k=YOUR_API_KEY&b=76
{has_contractbrewer} | Only render inner text if {has_contractbrewer} is true. |
{has_brewercity} | Only render inner text if {has_brewercity} is true. |
{has_abv} | Only render inner text if {has_abv} is true. |
{has_avg_rating} | Only render inner text if {has_avg_rating} is true. |
{is_retired} | Only render inner text if {is_retired} is true. |
{is_not_retired} | Only render inner text if {is_not_retired} is true. |
{has_overallpctl} | Only render inner text if {has_overallpctl} is true. |
{has_stylepctl} | Only render inner text if {has_stylepctl} is true. |
{is_alias} | Only render inner text if {is_alias} is true. |
{is_not_alias} | Only render inner text if {is_not_alias} is true. |
#_BEERID | The unique identifer associated with the beer. |
#_BREWERID | The unique identifer associated with the brewery. |
#_BREWERNAME | The brewery's name. |
#_CONTRACTBREWERID | The beer's contracted brewery identifier. |
#_CONTRACTBREWER | The beer's contracted brewery name. |
#_BEERNAME | The beer's name. |
#_RATECOUNT | The number (count) of ratings. |
#_AVERAGERATING | The beer's average rating. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_AVERAGERATING0. For 1 or 2 places of precision use #_AVERAGERATING1 or #_AVERAGERATING2. |
#_ENTERED | The date the beer (or brewer?) was added to RateBeer.com. |
#_OVERALLPCTL | The overall percentage represents a beer’s performance relative to all beers on an adjusted percentile basis. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_OVERALLPCTL0. For 1 or 2 places of precision use #_OVERALLPCTL1 or #_OVERALLPCTL2. |
#_STYLEPCTL | The style percentage represents a beer’s performance relative to its peers in the same beer style category on an adjusted percentile basis. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_STYLEPCTL0. For 1 or 2 places of precision use #_STYLEPCTL1 or #_STYLEPCTL2. |
#_ISALIAS | A boolean indicating whether this is an alias (another name) for a another beer. |
#_ALCOHOL | The beer's alcohol by volume. |
#_RETIRED | A boolean indicating whether the beer is retired. |
#_VERIFIED | Unknown. |
#_USERHADIT | When using 'userid' attribute, this is a boolean indicating whether the user has had the beer. |
#_USERRATING | When using 'userid' attribute, this the user's beer rating. |
#_BEERURL | The URL to the RateBeer.com beer web page. |
#_BEERLINK | A hyperlink to the RateBeer.com beer web page (uses #_BEERURL as href and #_BEERNAME as inner text values). |
#_BEERIMAGEURL | The URL to the RateBeer.com beer image. |
#_BEERIMAGE | An image HTML tag usingthe RateBeer.com beer image (uses #_BEERIMAGE as src and #_BEERNAME as alt values). |
#_BREWERURL | The URL to the RateBeer.com brewer web page. |
#_BREWERLINK | A hyperlink to the RateBeer.com brewer web page (uses #_BREWERURL as href and #_BREWERNAME as inner text values). |
#_BREWERIMAGEURL | The URL to the RateBeer.com brewer image. |
#_BREWERIMAGE | An image HTML tag usingthe RateBeer.com brewer image (uses #_BREWERIMAGE as src and #_BREWERNAME as alt values). |
Show beers available at a place.
Attributes
[beerratings-beer-place id='1105']
You may also enter multiple brewers IDs as shown in the examples below:
[beerratings-beer-place id='1105,14481']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/beershere.asp?k=YOUR_API_KEY&pid=1105
{has_avg_rating} | Only render inner text if {has_avg_rating} is true. |
#_BEERID | The unique identifer associated with the beer. |
#_BEERNAME | The beer's name. |
#_AVERAGERATING | The beer's average rating. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_AVERAGERATING0. For 1 or 2 places of precision use #_AVERAGERATING1 or #_AVERAGERATING2. |
#_TIMEENTERED | The time the beer was added to RateBeer.com. |
#_ISOUT | A boolean indicating if the beer is available at the place. |
#_BEERURL | The URL to the RateBeer.com beer web page. |
#_BEERLINK | A hyperlink to the RateBeer.com beer web page (uses #_BEERURL as href and #_BEERNAME as inner text values). |
#_BEERIMAGEURL | The URL to the RateBeer.com beer image. |
#_BEERIMAGE | An image HTML tag usingthe RateBeer.com beer image (uses #_BEERIMAGE as src and #_BEERNAME as alt values). |
Get the best beers. Returns the top 50 beers (worldwide).
Attributes
[beerratings-bestbeer]
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/tb.asp?k=YOUR_API_KEY&m=top50
{has_avg_rating} | Only render inner text if {has_avg_rating} is true. |
#_BEERID | The unique identifer associated with the beer. |
#_BEERNAME | The beer's name. |
#_BREWERID | The unique identifer associated with the brewery. |
#_BREWERNAME | The brewer's name. |
#_AVERAGERATING | The beer's average rating. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_AVERAGERATING0. For 1 or 2 places of precision use #_AVERAGERATING1 or #_AVERAGERATING2. |
#_RATECOUNT | The number (count) of ratings. |
#_BEERURL | The URL to the RateBeer.com beer web page. |
#_BEERLINK | A hyperlink to the RateBeer.com beer web page (uses #_BEERURL as href and #_BEERNAME as inner text values). |
#_BEERIMAGEURL | The URL to the RateBeer.com beer image. |
#_BEERIMAGE | An image HTML tag usingthe RateBeer.com beer image (uses #_BEERIMAGE as src and #_BEERNAME as alt values). |
#_BREWERURL | The URL to the RateBeer.com brewer web page. |
#_BREWERLINK | A hyperlink to the RateBeer.com brewer web page (uses #_BREWERURL as href and #_BREWERNAME as inner text values). |
#_BREWERIMAGEURL | The URL to the RateBeer.com brewer image. |
#_BREWERIMAGE | An image HTML tag usingthe RateBeer.com brewer image (uses #_BREWERIMAGE as src and #_BREWERNAME as alt values). |
Show top 50 beers by country. Optional userid shows you best beers the userid has not had.
Attributes
[beerratings-bestbeer-country id='213']
You may also enter multiple country IDs as shown in the examples below:
[beerratings-bestbeer-country id='213,39' show_retired='false' limit='5' sort='rating']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/tb.asp?k=YOUR_API_KEY&m=country&c=213
{has_avg_rating} | Only render inner text if {has_avg_rating} is true. |
{is_retired} | Only render inner text if {is_retired} is true. |
{is_not_retired} | Only render inner text if {is_not_retired} is true. |
#_BEERID | The unique identifer associated with the beer. |
#_BEERNAME | The beer's name. |
#_AVERAGERATING | The beer's average rating. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_AVERAGERATING0. For 1 or 2 places of precision use #_AVERAGERATING1 or #_AVERAGERATING2. |
#_RATECOUNT | The number (count) of ratings. |
#_RETIRED | A boolean indicating whether the beer is retired. |
#_BEERSTYLENAME | The beer's style name. |
#_USERHADIT | When using 'userid' attribute, this is a boolean indicating whether the user has had the beer. |
#_BEERURL | The URL to the RateBeer.com beer web page. |
#_BEERLINK | A hyperlink to the RateBeer.com beer web page (uses #_BEERURL as href and #_BEERNAME as inner text values). |
#_BEERIMAGEURL | The URL to the RateBeer.com beer image. |
#_BEERIMAGE | An image HTML tag usingthe RateBeer.com beer image (uses #_BEERIMAGE as src and #_BEERNAME as alt values). |
Show top 50 beers by season
Attributes
[beerratings-bestbeer-season id='1']
You may also enter multiple season IDs as shown in the examples below:
[beerratings-bestbeer-season id='1,2' limit='5' sort='rating']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/tb.asp?k=YOUR_API_KEY&m=season&season=1
{has_avg_rating} | Only render inner text if {has_avg_rating} is true. |
#_BEERID | The unique identifer associated with the beer. |
#_BEERNAME | The beer's name. |
#_BREWERID | The unique identifer associated with the brewery. |
#_BREWERNAME | The brewery's name. |
#_RATECOUNT | The number (count) of ratings. |
#_AVERAGERATING | The beer's average rating. This value will display full precision of the percentage (up to 10 places to the right of the decimal). To round the value, use #_AVERAGERATING0. For 1 or 2 places of precision use #_AVERAGERATING1 or #_AVERAGERATING2. |
#_BEERSTYLENAME | The beer's style name. |
#_BEERURL | The URL to the RateBeer.com beer web page. |
#_BEERLINK | A hyperlink to the RateBeer.com beer web page (uses #_BEERURL as href and #_BEERNAME as inner text values). |
#_BEERIMAGEURL | The URL to the RateBeer.com beer image. |
#_BEERIMAGE | An image HTML tag usingthe RateBeer.com beer image (uses #_BEERIMAGE as src and #_BEERNAME as alt values). |
#_BREWERURL | The URL to the RateBeer.com brewer web page. |
#_BREWERLINK | A hyperlink to the RateBeer.com brewer web page (uses #_BREWERURL as href and #_BREWERNAME as inner text values). |
#_BREWERIMAGEURL | The URL to the RateBeer.com brewer image. |
#_BREWERIMAGE | An image HTML tag usingthe RateBeer.com brewer image (uses #_BREWERIMAGE as src and #_BREWERNAME as alt values). |
Get the best beers by style. Returns the top 25 beers by beer style.
Attributes
[beerratings-bestbeer-style id='17']
You may also enter multiple style IDs as shown in the examples below:
[beerratings-bestbeer-style id='17,81' show_retired='false' limit='5']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/style.asp?k=YOUR_API_KEY&s=17
#_BEERID | The unique identifer associated with the beer. |
#_BEERNAME | The beer's name. |
#_BREWERID | The unique identifer associated with the brewery. |
#_BREWERNAME | The brewer's name. |
#_BEERURL | The URL to the RateBeer.com beer web page. |
#_BEERLINK | A hyperlink to the RateBeer.com beer web page (uses #_BEERURL as href and #_BEERNAME as inner text values). |
#_BEERIMAGEURL | The URL to the RateBeer.com beer image. |
#_BEERIMAGE | An image HTML tag usingthe RateBeer.com beer image (uses #_BEERIMAGE as src and #_BEERNAME as alt values). |
#_BREWERURL | The URL to the RateBeer.com brewer web page. |
#_BREWERLINK | A hyperlink to the RateBeer.com brewer web page (uses #_BREWERURL as href and #_BREWERNAME as inner text values). |
#_BREWERIMAGEURL | The URL to the RateBeer.com brewer image. |
#_BREWERIMAGE | An image HTML tag usingthe RateBeer.com brewer image (uses #_BREWERIMAGE as src and #_BREWERNAME as alt values). |
Get ratings (reviews) for a beer.
Attributes
[beerratings-beer-review id='32329']
[beerratings-beer-review id='32329' userid='71795']
[beerratings-beer-review id='32329' sort='highest_ratings' page='2']
Use the below URL(s) to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/gr.asp?k=YOUR_API_KEY&bid=32329
http://www.ratebeer.com/json/gr.asp?k=YOUR_API_KEY&pid=32329&uid=71795
http://www.ratebeer.com/json/gr.asp?k=YOUR_API_KEY&pid=32329&s=3&p=2
#_RESULTNUM | The result number starting at 1. |
#_RATINGID | The unique identifer associated with the review. |
#_APPEARANCE | The beer's appearance score. |
#_AROMA | The beer's aroma score. |
#_FLAVOR | The beer's flavor score. |
#_MOUTHFEEL | The beer's mouth feel score. |
#_OVERALL | The beer's overall score. |
#_TOTALSCORE | The beer's total score. |
#_COMMENTS | The beer review's comments. |
#_TIMEENTERED | The time the review was added to RateBeer.com. |
#_TIMEUPDATED | The time the review was last updated. |
#_USERID | The unique user identifier. |
#_USERNAME | The reviewer's username. |
#_CITY | The reviewer's city. |
#_STATEID | The unique state/subregion identifier associated with the reviewer. |
#_STATE | The reviewer's state/subregion. |
#_COUNTRYID | The unique country identifier associated with the reviewer. |
#_COUNTRY | The reviewer's country. |
#_RATECOUNT | The count of reviews given by the reviewer. |
#_USERURL | The URL to the RateBeer.com user web page. |
#_USERLINK | A hyperlink to the RateBeer.com user web page (uses #_USERURL as href and #_USERNAME as inner text values). |
Show brewer information by brewer ID.
Attributes
[beerratings-brewer id='76']
You may also enter multiple brewers IDs as shown in the examples below:
[beerratings-brewer id='76,198,11233']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/bi.asp?k=YOUR_API_KEY&b=76
{has_brewerdescription} | Only render inner text if {has_brewerdescription} is true. |
{has_breweraddress} | Only render inner text if {has_breweraddress} is true. |
{has_brewerwebsite} | Only render inner text if {has_brewerwebsite} is true. |
{has_facebook} | Only render inner text if {has_facebook} is true. |
{has_twitter} | Only render inner text if {has_twitter} is true. |
{has_breweremail} | Only render inner text if {has_breweremail} is true. |
{has_brewerphone} | Only render inner text if {has_brewerphone} is true. |
#_BREWERID | The unique identifer associated with the brewery. |
#_BREWERNAME | The brewery's name. |
#_BREWERDESCRIPTION | The brewery's description. |
#_BREWERADDRESS | The brewery's street address. |
#_BREWERCITY | The brewery's city. |
#_BREWERSTATEID | The unique state/subregion identifier associated with the brewery. |
#_BREWERSTATE | The brewery's state. |
#_BREWERCOUNTRYID | The unique country identifier associated with the brewery. |
#_BREWERCOUNTRY | The brewery's country. |
#_BREWERZIPCODE | The brewery's postal/zip code. |
#_BREWERTYPEID | The unique type identifer associated with the brewery. |
#_BREWERTYPE | The type of brewer. Types include 'Commercial Brewery', 'Microbrewery', 'Brew Pub', 'Brew Pub/Brewery', 'Contract Brewer', 'Meadery', 'Sake Producer', 'Cidery', 'Client Brewer'. |
#_BREWERWEBSITE | The brewery's web site URL. |
#_FACEBOOK | The brewery's facebook page/site. |
#_TWITTER | The brewery's twitter account. |
#_BREWEREMAIL | The brewery's email address. |
#_BREWERPHONE | The brewery's phone number. |
#_BARRELS | The number of barrels used by the brewery. |
#_OPENED | The date the brewery opened. |
#_ENTEREDON | The date the brewery was added to RateBeer.com. |
#_ENTEREDBY | The user id of the person who added the brewery to RateBeer.com. |
#_LOGOIMAGE | The brewery's logo image. |
#_VIEWCOUNT | Unknown. |
#_SCORE | Unknown. |
#_OOB | A boolean indicating whether the brewery is out of business. |
#_RETIRED | A boolean indicating whether the brewery is retired/closed. |
#_AREACODE | The brewery's area code. |
#_HOURS | The brewery's hours of operation. |
#_HEADBREWER | The name of the head brewer. |
#_METROID | The unique metro identifier associated with the brewery. |
#_MSA | Unknown. |
#_REGIONID | The unique region identifier associated with the brewery. |
#_BREWERURL | The URL to the RateBeer.com brewer web page. |
#_BREWERLINK | A hyperlink to the RateBeer.com brewer web page (uses #_BREWERURL as href and #_BREWERNAME as inner text values). |
#_BREWERIMAGEURL | The URL to the RateBeer.com brewer image. |
#_BREWERIMAGE | An image HTML tag usingthe RateBeer.com brewer image (uses #_BREWERIMAGE as src and #_BREWERNAME as alt values). |
Place information by place id.
Attributes
[beerratings-place id='7319']
You may also enter multiple place IDs as shown in the examples below:
[beerratings-place id='7319,14481']
Use the below URL to test your API key and see the raw JSON data.
http://www.ratebeer.com/json/pss.asp?k=YOUR_API_KEY&pid=1105
{has_address} | Only render inner text if {has_address} is true. |
{has_description} | Only render inner text if {has_description} is true. |
{is_retired} | Only render inner text if {is_retired} is true. |
{is_not_retired} | Only render inner text if {is_not_retired} is true. |
{has_avg_rating} | Only render inner text if {has_avg_rating} is true. |
{has_bay_mean} | Only render inner text if {has_bay_mean} is true. |
{has_percentile} | Only render inner text if {has_percentile} is true. |
{has_rate_count} | Only render inner text if {has_rate_count} is true. |
#_PLACEID | The unique identifier associated with the place. |
#_MAPID | Unknown. |
#_TOURID | Unknown. |
#_PLACENAME | The place's name. |
#_PLAINPLACENAME | The place's plain name. |
#_MSA | Unknown. |
#_REGIONID | The unique identifier associated with the place's region. |
#_LATITUDE | The place's latitude. |
#_LONGITUDE | The place's longitude. |
#_DESCRIPTION | The place's description. |
#_PLACETYPE | The type of place. |
#_ADDRESS | The place's street address. |
#_CITY | The place's city. |
#_STATEID | The unique state/subregion identifier associated with the place. |
#_STATE | The place's state/subregion. |
#_COUNTRYID | The unique country identifier associated with the place. |
#_COUNTRY | The place's country. |
#_POSTALCODE | The place's postal/ZIP code. |
#_PHONENUMBER | The place's phone number. |
#_WEBSITEURL | The place's web site URL. |
#_FACEBOOK | The place's Facebook page. |
#_TWITTER | The place's Twitter account. |
#_RATING | The place's overall rating. |
#_TAPS | The number of taps at the place. |
#_BOTTLES | A boolean indicating whether the place serves bottles. |
#_WIFI | A boolean indicating whether the place has Wi-Fi. |
#_TOGO | A boolean indicating whether the place has to go. |
#_SINGLES | A boolean indicating whether the place has singles. |
#_REALALES | A boolean indicating whether the place has real ales. |
#_RAREBEERS | A boolean indicating whether the place has rare beers. |
#_MACROS | A boolean indicating whether the place has macro beers. |
#_GLASSWARE | A boolean indicating whether the place uses proper glassware. |
#_SMOKING | A boolean indicating whether the place allows smoking. |
#_CIGARS | A boolean indicating whether the place allows cigars. |
#_CHILDREN | A boolean indicating whether the place allows children. |
#_RESERVATIONS | A boolean indicating whether the place requires reservations. |
#_PATIO | A boolean indicating whether the place has patio seating. |
#_TV | A boolean indicating whether the place has a television. |
#_GAMES | A boolean indicating whether the place has games. |
#_SCENE | The place's scene description. |
#_STAFF | The place's staff description. |
#_PARKING | The place's parking description. |
#_MUSIC | The place's music description. |
#_EVENTS | The place's events description. |
#_NOISE | The place's noise description. |
#_SEATING | The place's seating description. |
#_FOOD | The place's food description. |
#_COMMENTS | The place's comments. |
#_HOURS | The place's hours of operation. |
#_USERID | The unique user identifier of the person who added the place to RateBeer.com |
#_EDITEDBY | The unique user identifier of the person who last edited the place. |
#_TIMEADDED | The time the place was added to RateBeer.com. |
#_PHONECC | Unknown. |
#_PHONEAC | The area code of the place. . |
#_MAILORDER | A boolean indicating whether the place does mail order. |
#_MAILORDERINTL | A boolean indicating whether the place does mail order for international orders. |
#_AVGRATING | The place's average rating. |
#_BAYMEAN | The place's Bayesian mean (weighted average) rating. |
#_PERCENTILE | The overall percentage rating. |
#_RATECOUNT | The total number of ratings for the place. |
#_TIMEEDITED | The last time the place was edited. |
#_CURRENCY | The currency accepted by the place. |
#_RETIRED | A boolean indicating whether the place is retired. |
#_PLACEURL | The URL to the RateBeer.com place web page. |
#_PLACELINK | A hyperlink to the RateBeer.com place web page (uses #_PLACEURL as href and #_PLACENAME as inner text values). |