Browse the community feed or discover brewers
The BrewForge community. Without query/style: the feed of what the brewers the user follows brewed, packaged and shared (last 30 days, `days` for more), plus a few suggested brewers. With query and/or style (or view: "discover"): search other brewers' shared recipes by beer name, style or brewer name/handle (e.g. query "hopfenhans" or style "German Pilsner"), with suggested brewers. Use handles from the result with get_brewer_profile / interact_with_brewer, brew_id with cheer_brew, share_token with adopt_shared_recipe. Only brewers with an open profile appear. Scope: `community:read` (or `read`).
The BrewForge community. Without query/style: the feed of what the brewers the user follows brewed, packaged and shared (last 30 days, days for more), plus a few suggested brewers. With query and/or style (or view: "discover"): search other brewers' shared recipes by beer name, style or brewer name/handle (e.g. query "hopfenhans" or style "German Pilsner"), with suggested brewers. Use handles from the result with get_brewer_profile / interact_with_brewer, brew_id with cheer_brew, share_token with adopt_shared_recipe. Only brewers with an open profile appear.
Scope: community:read (or read).
API token in format: bfk_. Each operation lists the token scope it requires (the scopes are listed below).
read: Read everything (all areas)write: Create, change and delete everything (all areas)brews:read: List and view brewsbrews:write: Create, update, delete brews and notesinventory:read: List inventory itemsinventory:write: Create, update, delete inventory itemsequipment:read: List equipment profilesequipment:write: Create, update, delete equipment profilesstyles:read: List style profilesstyles:write: Create, update, delete style profilesprofiles:read: List mash, fermentation, and water profilescustom-fields:read: List custom field definitionscustom-fields:write: Create, update, delete custom field definitionsprofiles:write: Create, update, delete mash, fermentation, and water profilescellar:read: View cellar, packaged stock, tap lists, and labelscellar:write: Manage cellar, packaging, stock, tap lists, and labelssettings:read: View preferences, imports, calculators, and your data exportsettings:write: Change preferences and undo importscommunity:read: View community, feedback, tickets, inbox, and account overviewcommunity:write: Post, vote, and reply in community, feedback, and tickets
In: header
Scope: community:read
Request Body
application/json
"feed" (default) or "discover". Passing query or style switches to discover.
"feed" | "discover"Beer name, style or brewer name/handle to search for, e.g. "pils" or "hopfenhans".
length <= 80Exact style name of shared recipes, e.g. "American IPA". The discover result lists available styles.
length <= 80Feed only: days to look back, 30-365 (default 30).
30 <= value <= 365Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://brewforge.sh/api/v1/actions/browse_community" \ -H "Content-Type: application/json" \ -d '{}'{
"view": "feed",
"following": 0,
"entries": [
{
"kind": "brewed",
"date": "string",
"brewer": {
"handle": "string",
"name": "string",
"location": "string"
},
"brew_id": "string",
"beer": "string",
"style": "string",
"milestone": 0,
"share_token": "string",
"based_on": "string",
"cheers": 0,
"cheered_by_you": true
}
],
"has_older": true,
"recipes": [
{
"brew_id": "string",
"name": "string",
"style": "string",
"brewer": {
"handle": "string",
"name": "string",
"location": "string"
},
"abv_pct": 0,
"ibu": 0,
"brewed_by": 0,
"cheers": 0,
"share_token": "string"
}
],
"styles": [
"string"
],
"suggested_brewers": [
{
"handle": "string",
"name": "string",
"location": "string",
"styles": [
"string"
],
"listed_recipes": 0,
"new_here": true
}
],
"note": "string"
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}{
"error": {
"code": "string",
"message": "string",
"hint": "string",
"candidates": [
{
"id": "string",
"name": "string"
}
],
"fields": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"details": {}
}
}