Pepesto

Turn any recipe — URL, text, or photo — into a matched basket of real supermarket products with live prices across 26 European supermarkets. One API, structured JSON, ready for agents.

原始信息汇总

数据集概述：Pepesto Grocery Shopping API

Pepesto 是一个面向欧洲超市的食品杂货智能 API，旨在帮助开发者构建购物代理、菜谱应用、膳食规划工具和价格追踪系统。它将任何食谱（通过 URL、文本或图像）转化为包含真实商品和实时价格的购物篮。

核心功能与用例

• 一键转化： 通过 /oneshot 端点，一次调用即可将食谱 URL 解析、匹配、构建购物会话，并返回可直接结账的 URL。
• 食谱发现与匹配：
  • 使用 /suggest 端点搜索超过 100 万食谱的知识图谱，返回 3 个候选食谱及其 kg_token。
  • 将 kg_token 与指定超市域名传入 /products 端点，获取匹配的商品及其价格。
• 自定义食谱解析： 使用 /parse 端点解析用户提供的食谱 URL 或文本，返回结构化的配料列表和 kg_token，再通过 /products 匹配商品。
• 多食谱合并购物车： 在一次 /products 调用中传入多个 kg_token，Pepesto 会自动合并重复的配料。
• 跨超市比价： 对同一个 kg_token，使用不同 supermarket_domain 多次调用 /products，即可比较各超市的总价。
• 促销商品获取： 使用 /promotions 端点按超市拉取促销商品。
• 商品目录分析： 使用 /catalog 端点获取超市的完整 SKU 数据（约 1000-2000 个 SKU），用于市场分析或比价仪表盘。

目标用户

• AI 智能体：提供干净的 JSON 数据和确定性的 schema，并兼容 MCP 服务器。
• 购物与膳食规划应用：提供可直接结账的购物篮。
• 价格情报平台：支持跨零售商的价格比较。
• 食谱平台：支持“一键购物”功能。

关键数据结构

• 价格：以最小货币单位（如分、便士）的整数表示。
• kg_token：由 /parse 或 /suggest 返回的食谱标识，用于作为 /products 的输入。
• session_token：由 /products 返回的单品标识，用于 /session 端点。
• 支持的货币：EUR, GBP, CHF, NOK, PLN, BGN, DKK。

支持的超市列表（26家，覆盖13个国家）

序号	国家	超市名称	域名 / ID
1	🇬🇧 英国	Tesco	tesco.com
2	🇬🇧 英国	Sainsburys	sainsburys.co.uk
3	🇬🇧 英国	ASDA	asda.com
4	🇬🇧 英国	Morrisons	groceries.morrisons.com
5	🇬🇧 英国	Waitrose	waitrose.com
6	🇳🇱 荷兰	Albert Heijn	ah.nl
7	🇳🇱 荷兰	Jumbo	jumbo.com
8	🇳🇱 荷兰	Plus NL	plus.nl
9	🇩🇪 德国	Rewe	shop.rewe.de
10	🇨🇭 瑞士	Coop CH	coop.ch
11	🇨🇭 瑞士	Migros	migros.ch
12	🇨🇭 瑞士	Farmy	farmy.ch
13	🇨🇭 瑞士	Aldi CH	aldi-now.ch
14	🇧🇪 比利时	Colruyt	colruyt.be
15	🇧🇪 比利时	Delhaize	delhaize.be
16	🇮🇪 爱尔兰	Tesco IE	tesco.ie
17	🇮🇪 爱尔兰	SuperValu	shop.supervalu.ie
18	🇮🇪 爱尔兰	Dunnes	dunnesstoresgrocery.com
19	🇮🇹 意大利	Esselunga	spesaonline.esselunga.it
20	🇮🇹 意大利	Conad	spesaonline.conad.it
21	🇩🇰 丹麦	Nemlig	nemlig.com
22	🇳🇴 挪威	Meny	meny.no
23	🇵🇱 波兰	Frisco	frisco.pl
24	🇵🇱 波兰	Auchan PL	zakupy.auchan.pl
25	🇧🇬 保加利亚	Bulmag	bulmag.org
26	🇧🇬 保加利亚	eBag	ebag.bg

结账方式

• 托管结账（推荐）：通过 /oneshot 获得的 redirect_url 或使用 /session 构建的结账链接，进入 Pepesto 托管的结账流程。
• 自动化结账：通过 /session 和 /checkout 端点组合，直接在超市的网站上执行浏览器自动化结账循环。

定价与最佳实践

• 采用按需付费的积分制，积分 永不过期。
• /credits 和 /link 端点免费。
• /catalog 是资源消耗最大的端点，建议对每个超市的结果至少缓存一天。
• 完整的按调用计费详情和批量折扣请参考：Pepesto 定价页面。