Punk API is a free, no-auth REST API exposing BrewDog's "DIY Dog" open-source beer recipe collection — 325 detailed homebrew recipes crowdsourced and transcribed from the BrewDog DIY Dog PDF. The v2 surface (api.punkapi.com/v2) offered three read-only endpoints: list beers (with rich query filtering on ABV, IBU, EBC, brew date, beer name, hops, malt, yeast, and food pairing), get a beer by id, and get a random beer. Each beer carries a full recipe — ABV, IBU, EBC/SRM colour, target gravities, mash temperature schedule, fermentation temperature, twist, malt and hop bills, yeast strain, food pairings, brewer's tips, and contributor attribution. STATUS — DEPRECATED. BrewDog decommissioned the public api.punkapi.com endpoint in 2023 and the source repositories (sammdec/punkapi-db, sammdec/punkapi-server) were archived on 2023-06-28. The dataset and server source remain MIT-licensed and available; community-hosted mirrors and the `punkapi-db` npm package preserve the contract documented here.
Punk API publishes 1 API on the APIs.io network: Beers API. Tagged areas include Food And Drink, Beer, BrewDog, DIY Dog, and Recipes.
The Punk API catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Create-or-Update Ergonomics does not apply to this provider. The published contracts declare
no write operations, and a read-only API cannot create-or-update. The facet is excluded from this provider's
denominator entirely — not scored zero. A reference or data API is not deficient for being unable to
upsert.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/punkapi: open an issue to ask a question, or submit a pull request to add artifacts.
Submit an artifact on GitHub — free →Manage your own listing — the Influence plan, $499/mo →
Crowdsourced transcription of the complete BrewDog DIY Dog PDF — every recipe from Punk IPA (#001) through the final published batch.
Full Brewing Recipe
Each beer carries ABV, IBU, EBC, SRM, target gravities, mash schedule, fermentation temperature, malt bill, hop bill, yeast strain, food pairings, and brewer's tips.
Recipe-Oriented Query Filters
List endpoint supports filters on ABV (gt/lt), IBU (gt/lt), EBC (gt/lt), brewed-before/after dates, and substring search on beer name, hops, malt, yeast, and food pairing.
Pagination
page (>=1) and per_page (1-80, default 25) on the list endpoint.
Random Beer
/beers/random returns a uniformly random recipe — useful for "beer of the day" demos.
No Authentication
Fully public — no API keys, OAuth, or signup required.
No Rate Limits Documented
Best-effort public service while it was live. Only the per_page ceiling of 80 is enforced.
MIT-Licensed Source
Both punkapi-db (dataset) and punkapi-server (Express app) are MIT-licensed — self-host or fork freely.
npm Distribution
The complete dataset is published as the `punkapi-db` package for direct in-process use without HTTP.
aid: punkapi
deliveryModel:
model: unknown
open_source: unknown
commercial: true
callable_host: false
label: Delivery model not determined — needs a product licence on record
confidence: low
source:
- openapi
- pricing
- repository-unlicensed
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: unknown
trial: false
try_now: false
public: false
label: Freemium
confidence: medium
source:
- plans
generated: '2026-07-22'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/punkapi.png
name: Punk API
description: 'Punk API is a free, no-auth REST API exposing BrewDog''s "DIY Dog" open-source beer recipe collection — 325
detailed homebrew recipes crowdsourced and transcribed from the BrewDog DIY Dog PDF. The v2 surface (api.punkapi.com/v2)
offered three read-only endpoints: list beers (with rich query filtering on ABV, IBU, EBC, brew date, beer name, hops, malt,
yeast, and food pairing), get a beer by id, and get a random beer. Each beer carries a full recipe — ABV, IBU, EBC/SRM colour,
target gravities, mash temperature schedule, fermentation temperature, twist, malt and hop bills, yeast strain, food pairings,
brewer''s tips, and contributor attribution. STATUS — DEPRECATED. BrewDog decommissioned the public api.punkapi.com endpoint
in 2023 and the source repositories (sammdec/punkapi-db, sammdec/punkapi-server) were archived on 2023-06-28. The dataset
and server source remain MIT-licensed and available; community-hosted mirrors and the `punkapi-db` npm package preserve
the contract documented here.'
url: https://punkapi.com
baseURL: https://api.punkapi.com/v2
specificationVersion: '0.23'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-category: Food & Drink
x-type: opensource
x-tier: 3
x-tier-reason: free-deprecated-public-service-with-archived-open-source-source-code
x-status: deprecated
x-deprecated-on: '2023'
x-archived-on: '2023-06-28'
x-replacement: Self-host sammdec/punkapi-server against the `punkapi-db` npm dataset, or point clients at a community-maintained
mirror.
tags:
- Food And Drink
- Beer
- BrewDog
- DIY Dog
- Recipes
- Open-Source
- Public APIs
- REST
- Deprecated
tags_raw:
- Food And Drink
- Beer
- BrewDog
- DIY Dog
- Recipes
- Open Source
- Public APIs
- REST
- Deprecated
apis:
- aid: punkapi:punkapi-beers-api
name: Punk API Beers API
description: BrewDog DIY Dog beer recipes — 325 entries
humanURL: https://punkapi.com
baseURL: https://api.punkapi.com/v2
tags:
- Beers
properties:
- type: OpenAPI
url: openapi/punkapi-beers-api-openapi.yml
- type: Documentation
url: https://punkapi.com
- type: JSONSchema
url: json-schema/punkapi-beer-schema.json
- type: JSONSchema
url: json-schema/punkapi-error-schema.json
- type: JSONStructure
url: json-structure/punkapi-beer-structure.json
- type: JSONStructure
url: json-structure/punkapi-error-structure.json
- type: JSONLD
url: json-ld/punkapi-context.jsonld
- type: Examples
url: examples/punkapi-beer-example.json
- type: Examples
url: examples/punkapi-error-example.json
common:
- type: IssueTracker
url: https://github.com/sammdec/punkapi/issues
- type: AgenticAccess
url: agentic-access/punkapi-agentic-access.yml
- type: DomainSecurity
url: security/punkapi-domain-security.yml
- type: Website
url: https://punkapi.com
- type: GitHubRepository
url: https://github.com/sammdec/punkapi
title: punkapi-db (Recipe Dataset — archived 2023-06-28)
- type: GitHubRepository
url: https://github.com/sammdec/punkapi-server
title: punkapi-server (Express server — archived 2023-06-28)
- type: GitHubOrganization
url: https://github.com/sammdec
- type: SDKs
url: https://www.npmjs.com/package/punkapi-db
title: punkapi-db (npm — recipe dataset)
- type: SDKs
url: https://github.com/apfohl/punkapi
title: punkapi (C client)
- type: SDKs
url: https://github.com/samjbmason/punkapi-ruby
title: punkapi-ruby (Ruby client)
- type: SDKs
url: https://github.com/billythekid/PunkApi
title: PunkApi (PHP client)
- type: SDKs
url: https://github.com/mikefrancis/brewdog.js
title: brewdog.js (JavaScript client)
- type: SDKs
url: https://github.com/Oni-zerone/PunkAPI
title: PunkAPI (Swift/iOS client)
- type: SDKs
url: https://github.com/yoohahn/VueDogs-API
title: VueDogs-API (Vue.js client)
- type: SDKs
url: https://hub.docker.com/r/yoohahn/brewdog-recipe
title: brewdog-recipe (Docker mirror)
- type: SDKs
url: https://github.com/phillc73/brewdogr
title: brewdogr (R client)
- type: PublicAPIsListing
url: https://github.com/public-apis/public-apis
- type: Plans
url: plans/punkapi-plans-pricing.yml
- type: RateLimits
url: rate-limits/punkapi-rate-limits.yml
- type: SpectralRules
url: rules/punkapi-rules.yml
- type: Vocabulary
url: vocabulary/punkapi-vocabulary.yml
- type: Features
data:
- name: 325 BrewDog DIY Dog Recipes
description: Crowdsourced transcription of the complete BrewDog DIY Dog PDF — every recipe from Punk IPA (#001) through
the final published batch.
- name: Full Brewing Recipe
description: Each beer carries ABV, IBU, EBC, SRM, target gravities, mash schedule, fermentation temperature, malt bill,
hop bill, yeast strain, food pairings, and brewer's tips.
- name: Recipe-Oriented Query Filters
description: List endpoint supports filters on ABV (gt/lt), IBU (gt/lt), EBC (gt/lt), brewed-before/after dates, and substring
search on beer name, hops, malt, yeast, and food pairing.
- name: Pagination
description: page (>=1) and per_page (1-80, default 25) on the list endpoint.
- name: Random Beer
description: /beers/random returns a uniformly random recipe — useful for "beer of the day" demos.
- name: No Authentication
description: Fully public — no API keys, OAuth, or signup required.
- name: No Rate Limits Documented
description: Best-effort public service while it was live. Only the per_page ceiling of 80 is enforced.
- name: MIT-Licensed Source
description: Both punkapi-db (dataset) and punkapi-server (Express app) are MIT-licensed — self-host or fork freely.
- name: npm Distribution
description: The complete dataset is published as the `punkapi-db` package for direct in-process use without HTTP.
- type: UseCases
data:
- name: Homebrewing Reference
description: Look up a recipe by ABV, hop, or malt to replicate or adapt a BrewDog beer at home-batch scale.
- name: Sample / Tutorial API
description: Front-end and mobile tutorials use Punk API as a fun, schema-rich, no-auth REST target.
- name: Beer Discovery App
description: Power beer recommendation apps, food-pairing tools, and BrewDog fan sites.
- name: Search by Ingredient
description: Filter by hop (e.g. `hops=simcoe`) or malt (e.g. `malt=maris_otter`) to discover recipes using a specific
ingredient.
- name: Food Pairing Lookup
description: Filter by `food=spicy_food` to find beers explicitly recommended for spicy cuisine.
- name: HTTP Client QA
description: Stable, well-defined schema makes Punk API a good fixture for codegen tools, OpenAPI tooling, and SDK builders.
- type: Integrations
data:
- name: BrewDog DIY Dog
description: The upstream source of every recipe — BrewDog's open-source DIY Dog homebrew PDF.
- name: punkapi-db (npm)
description: The recipe dataset packaged for direct npm install — no HTTP needed.
- name: punkapi-server (Express)
description: The reference Express + node server that exposes the dataset as the v2 REST API.
- name: Community Mirrors
description: Several community-run instances of punkapi-server keep the v2 contract reachable after BrewDog's 2023 decommission.
- name: Public APIs Catalog
description: Listed in github.com/public-apis/public-apis under the Food & Drink category.
- type: Solutions
data:
- name: Self-Host the Server
description: Clone sammdec/punkapi-server, run `npm i` then `npm run dev` — get the full v2 contract on http://localhost:3333.
- name: Embed the Dataset
description: Run `npm i --save punkapi-db` to pull the full 325-recipe data.json into your application without HTTP.
- name: Static JSON Mirror
description: For purely read use cases, host data.json on a CDN and serve clients directly.
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →