# Pikaproteiini

> Finnish nutrition data site (https://www.pikaproteiini.fi): calories, protein, fat and carbs of Finnish fast food chain menu items and supermarket ready meals, shown on a map and as top lists. The full data is published as open files for AI agents and other third parties.

## Datasets

- [Pikaruoat (fast food), JSON](https://www.pikaproteiini.fi/data-export/pikaruoat.json): about 660 menu items from 11 Finnish fast food chains (Hesburger, McDonald's, Burger King, Subway, Kotipizza etc.). Values are PER PORTION.
- [Pikaruoat, CSV](https://www.pikaproteiini.fi/data-export/pikaruoat.csv): same data as CSV.
- [Valmisruoat (ready meals), JSON](https://www.pikaproteiini.fi/data-export/valmisruoat.json): about 1300 ready meals sold by S-kaupat and K-Ruoka. Values are PER 100 g; multiply by `weight` / 100 for the whole package.
- [Valmisruoat, CSV](https://www.pikaproteiini.fi/data-export/valmisruoat.csv): same data as CSV.

JSON shape: `{ "updated": "YYYY-MM-DD", "source", "license", "count", "items": [...] }`. CSV is UTF-8 with a header row; several links are joined with ` | `. The files allow cross-origin requests.

## Fields

- `id`: stable identifier. Ready meals: EAN code. Fast food: chain-category-name slug.
- `chain`: fast food chain. In ready meals the brand used as a filter on the site: one of the 16 largest brands or "Muut merkit" (other brands).
- `brand` (ready meals): manufacturer brand.
- `name`: product name in Finnish. `aka` (ready meals, mostly empty): the manufacturer's own product name when the shops list it differently.
- `category`: category as given by the chain or shop. `group`: the site's own unified category (Finnish).
- `kcal`: energy, kilocalories. `protein`, `fat`, `carbs`: grams. `salt` (ready meals): grams. Fast food: per portion. Ready meals: per 100 g. Empty = not declared.
- `weight`: portion or package weight in grams (may be empty).
- `protein_per_100kcal`: grams of protein per 100 kcal (derived, 1 decimal).
- `frozen` (ready meals): true for frozen products.
- `part` (ready meals): true when the product is a meal component eaten with something else (meatballs, kebab strips, side salads), false for complete meals.
- `links`: original source pages as `[label, url]` pairs (chain product page or shop product pages).
- `url`: link that opens the product on pikaproteiini.fi (the map filtered by the product name).

## Updates

Each file carries its own `updated` date. Data is refreshed irregularly; menus and recipes change, so check the `links` source for anything critical.

## Terms

Free to use for any purpose, no attribution required (CC0). No warranty of accuracy: values are declared by the chains and manufacturers and collected automatically. Product images are not included and are not covered by these terms.

Human-readable page in Finnish: https://www.pikaproteiini.fi/agenteille.html