public

Search a city's beer prices

The ranking with filters, cheapest per litre first (at most 50). Open bars only with kind=open_bar, by package price. Prices older than 180 days are left out. Answers are cached for a few minutes.

get/api/v1/search

Request

  • Base URL: https://cervejabarata.com.br
  • URL: https://cervejabarata.com.br/api/v1/search
  • Auth: none declared

Query parameters

citystring required

City slug, e.g. "salvador" (see /api/v1/cities.json)

neighbourhoodstring

Bairro slug

brandstring

Brand slug, e.g. "brahma"

formatstring

Format type (lata, long_neck, garrafa, litrao, chopp, torre) or code (garrafa_600)

kind'regular' | 'happy_hour' | 'promo' | 'combo' | 'open_bar'

Only this kind of price; open bars only with open_bar

max_price_per_litrenumber

In BRL per litre

limitinteger
lang'pt-BR' | 'en'

Language of labels, schedules and page links

Response

Prices

citystring required
city_urlstring required
as_ofstring required
countinteger required
sourcestring required

Attribution: Cerveja Barata (cervejabarata.com.br), ODbL

local_timestring

The city's time (cheapest only)

Changes

No recorded changes to this operation across all 1 revision of this API.