# Punk API

**Canonical:** https://apis.io/providers/punkapi/  
**Website:** https://punkapi.com  
**APIs profiled:** 1

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.

## Kin Score — 39.6 / 100 (developing)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 39.6).

| Facet | Score |
|---|---|
| Discoverability | 75.9 |
| Contract Quality | 68.1 |
| Governance | 25.0 |
| Contract Governance | 25.0 |
| Operational Transparency | 34.2 |
| Developer Ergonomics | 16.7 |
| Commercial Clarity | 21.1 |
| Access Clarity | 21.1 |

## Agent readiness — 36.2 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | na |
| MCP Server | no |
| Auth Clarity | no |
| Idempotency | na |
| Error Semantics | verified |
| OpenAPI Examples | partial |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | na |

## Access

Freemium — onboarding: unknown, pricing: freemium, trial: no (confidence: medium).

## APIs (1)

- **Punk API Beers API** — BrewDog DIY Dog beer recipes — 325 entries

## Agentic access (1)

- **Punkapi Agentic Access** — 3 operations

## Security (1)

- **Punkapi Domain Security** — DNSSEC

## Plans (1)

- **Punkapi Plans Pricing**

## Use cases (6)

- **Homebrewing Reference** — Look up a recipe by ABV, hop, or malt to replicate or adapt a BrewDog beer at home-batch scale.
- **Sample / Tutorial API** — Front-end and mobile tutorials use Punk API as a fun, schema-rich, no-auth REST target.
- **Beer Discovery App** — Power beer recommendation apps, food-pairing tools, and BrewDog fan sites.
- **Search by Ingredient** — Filter by hop (e.g. `hops=simcoe`) or malt (e.g. `malt=maris_otter`) to discover recipes using a specific ingredient.
- **Food Pairing Lookup** — Filter by `food=spicy_food` to find beers explicitly recommended for spicy cuisine.
- **HTTP Client QA** — Stable, well-defined schema makes Punk API a good fixture for codegen tools, OpenAPI tooling, and SDK builders.

## Tags

Food And Drink, Beer, BrewDog, DIY Dog, Recipes, Open-Source, Public APIs, REST, Deprecated

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/punkapi/). Scores are computed from the provider's own public artifacts under a published rubric.