Cookspert API

Recipe intelligence for developers

Parse recipe URLs and free text, extract and normalize ingredients, and calculate nutrition — the same engine that powers Cookspert, delivered as structured JSON.

Get an API key Read the docs

Capabilities

Everything the Cookspert app knows, as an API

Six endpoints across recipe parsing and ingredient intelligence — the same services behind every Cookspert product.

Parse recipe URLs

Point the API at a public recipe page and get back a structured recipe.

Parse recipe text

Free-form recipe text in; ingredients, servings and steps out.

Extract structured ingredients

Every ingredient line matched against a curated dictionary of 3,000+ ingredients.

Normalize quantities & units

Cups, grams, pieces — converted and comparable through each ingredient's own conversion data.

Calculate nutrition

Calories, macros and price estimates computed per ingredient and per serving.

English, Spanish and Bulgarian

The parser language is auto-detected from the text itself — no locale parameter required.

For developers & businesses

The Cookspert Recipe Intelligence API

The same recipe intelligence that powers Cookspert is available through the Cookspert API — one endpoint turns any recipe URL or block of text into clean, structured data.

curl https://api.cookspert.com/v1/parse \
  -H "Authorization: Bearer ck_live_..." \
  -d url="https://bonapeti.bg/recipe/123"

{
  "title": "Pumpkin ginger cream soup",
  "cuisine": "Bulgarian",
  "method": ["simmer", "blend"],
  "time_minutes": 35,
  "servings": 4,
  "ingredients": [
    { "name": "pumpkin", "qty": 600, "unit": "g" },
    { "name": "ginger", "qty": 15, "unit": "g" }
  ],
  "nutrition": { "kcal": 165, "protein_g": 6, "carbs_g": 22, "fat_g": 7 },
  "language": "bg"
}

Parse recipe URLs or free text

Ingredient extraction & normalization

Nutrition calculation

Cuisine & cooking-method detection

Cook-time estimation

English & Bulgarian parsing

Structured JSON, always

Usage-based pricing

Explore the API Read the docs

Getting started

From sign-up to first call in minutes

No sales call required — the free tier includes 5,000 credits a month.

1
Create an account
Sign up free — no card required.
2
Create an API key
Generate a key in the developer dashboard. The secret is shown exactly once.
3
Call the API
Authenticate with a bearer token and parse your first recipe.

API pricing