Pepesto
## What is it? Pepesto is a grocery intelligence API — also available as an MCP server — for developers building shopping agents, recipe apps, meal planners, and price-tracking tools across European supermarkets. ## 7 quick use cases on how to use the Pepesto API ### Recipe URL → matched cart (one call) The fastest path. `/oneshot` parses, matches, builds a session, and returns a checkout URL.…
Pepesto endpoints
| Method | Endpoint | Description |
|---|---|---|
| Account | ||
| POST |
createApiKey /link |
Creates an API key linked to a previously completed Stripe payment. The key is returned **only once** — store it immediately. Pass an optional `alias` when you need multiple keys… |
| POST |
getCredits /credits |
Returns the remaining credit balance for the configured API key. |
| Recipes | ||
| POST |
parseRecipe /parse |
Extracts a structured recipe (title, ingredients, steps, nutrition, image) from a URL or free-form text. Returns a `kg_token` you can pass to `/products` to match ingredients to… |
| POST |
suggestRecipes /suggest |
Searches Pepesto's recipe graph (1M+ recipes) by free-text query. The query may include cuisine, dietary tags, ingredients to include or avoid, time constraints, and servings… |
| Cart | ||
| POST |
oneshot /oneshot |
Combines parse + product matching + session creation in a single call. Pass any combination of recipe URLs, free-form shopping text, and/or a base64-encoded image, plus a target… |
| POST |
products /products |
Maps one or more recipe `KgToken`s — and an optional manual shopping list — to concrete supermarket SKUs with prices, images, and quantities. Items are merged across recipes to… |
| Checkout | ||
| POST |
createSession /session |
Wraps a final basket as a session for the chosen supermarket. The returned `session_id` is what you feed to `/checkout` to drive the supermarket's own site. Provide `skus`… |
| POST |
checkoutIteration /checkout |
Drives one step of the AI-guided checkout loop. Each call returns a single instruction wrapped in `proto` for the client to execute — the instruction kind depends on what surface… |
| Catalog | ||
| POST |
promotions /promotions |
Returns the subset of the catalog currently on promotion — same shape as `/catalog` but filtered to entries with `promo: true`. Convenient when you only care about discounted… |
| POST |
catalogDump /catalog |
Returns Pepesto's full indexed catalog for a supermarket — typically 1,000–2,000 SKUs of common cooking ingredients keyed by their canonical URL on the supermarket's site. Use… |
Pepesto pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC Recommended | Free | — |
|