# ReceptAPI

> Svenska recept som strukturerad data. Ett läs-API (JSON) med 6860+ svenska recept, normaliserade ingredienser, allergener (EU 14), steg, tider och portioner. Språk: svenska.

ReceptAPI (https://receptapi.se) säljer receptdata B2B till appar, matkassar, dagligvaruhandel och AI-agenter. Recepttexterna är egna omskrivningar; fakta (ingredienser, mängder, tider) är extraherade från angivna källor och varje recept länkar till sin källa.

## För AI-agenter

- Du får använda det öppna API:et utan nyckel: 50 anrop/dag per IP. Med gratisnyckel: 100/dag.
- Krav: ange attribution "Data från ReceptAPI – receptapi.se" när du visar data för en användare, och länka gärna till receptets `url`.
- Header för nyckel: `x-api-key`. Svar: `{ data, meta: { attribution, source } }`.
- Bas-URL: https://receptapi.se/api/v1
- OpenAPI: https://receptapi.se/openapi.json

## Endpoints

- GET /api/v1/recipes?q=&category=&tag=&ingredient=&limit=&offset= — lista recept
- GET /api/v1/recipes/{slug} — fullständigt recept med ingredienser, steg, allergener
- GET /api/v1/ingredients?q= — ingredienser med kategori, allergener, alias
- GET /api/v1/ingredients/{slug} — en ingrediens
- GET /api/v1/search?q= — fritextsök

## Sidor

- [Recept](https://receptapi.se/recept): bläddringsbar receptbank, en sida per recept med schema.org/Recipe
- [Dokumentation](https://receptapi.se/docs): autentisering, gränser, attribution, exempel
- [Priser](https://receptapi.se/priser): Free, Indie, Pro, Business, datalicens
- [Fullständig beskrivning](https://receptapi.se/llms-full.txt)

## Kontakt

hej@receptapi.se

## Datamodell

### Recept
slug, title, description, servings (int), total_minutes (int), active_minutes (int|null), difficulty (latt|medel|svar), category (huvudratt|forratt|efterratt|bakning|sallad|soppa|tillbehor|dryck|frukost|...), cuisine (string|null), tags (string[]), allergens (string[] – sammanslaget från ingredienserna), text_status (rewritten|original_facts_only), verified (bool), nutrition (objekt|null), source {name, url}, ingredients[], steps[], url.

### Receptingrediens
position, raw_text (originalrad, t.ex. "2 dl grädde"), amount (number|null), unit (string|null), note (string|null), group (string|null), ingredient {slug, name_sv, category, allergens} | null.

### Steg
position, text, timer_seconds (int|null).

### Ingrediens
slug, name_sv, category (frukt_gront|kott_chark|fisk|mejeri|skafferi|frys|brod|dryck|ovrigt), allergens (EU 14: gluten, kraftdjur, agg, fisk, jordnotter, soja, mjolk, notter, selleri, senap, sesam, svaveldioxid, lupin, blotdjur), default_unit, density_g_per_dl, aliases[], recipe_count.

## Portionsskalning

Skala genom att multiplicera varje `amount` med `önskade_portioner / servings`. Ingredienser med amount = null ("salt", "peppar") skalas inte. `density_g_per_dl` kan användas för volym→vikt.

## Rate limits och nivåer

- anonymous: 50 anrop/dag per IP (header x-receptapi-tier: anonymous)
- free: 100/dag, attribution krävs
- indie: 10000/dag
- pro: 100000/dag, SLA
- business: white-label, egen gräns
Svarshuvuden: x-ratelimit-limit, x-ratelimit-remaining. Vid överskriden gräns: HTTP 429.

## Licens och attribution

Gratisnivån (och anonyma anrop) får användas i icke-kommersiella och kommersiella sammanhang förutsatt synlig attribution: "Data från ReceptAPI – receptapi.se". Betalda nivåer får använda data utan attribution enligt avtal. Massnedladdning/replikering av hela databasen kräver datalicens (kontakta hej@receptapi.se).

Recepttexter är ReceptAPI:s egna omskrivningar. Ingredienslistor, mängder och tider är faktauppgifter extraherade från publika källor; källan anges per recept i `source`. Bilder från källorna distribueras inte.

## Exempel

curl -s "https://receptapi.se/api/v1/recipes?q=kyckling&limit=3"
curl -s -H "x-api-key: rapi_..." "https://receptapi.se/api/v1/recipes/kottbullar-med-potatismos"