LatAm Grocery Price Intelligence API

Real-time, SKU-level grocery prices from Argentina's top supermarkets. Search products, compare any barcode across retailers, and price a whole basket.

原始信息汇总

数据集概述：LatAm Grocery Price Intelligence API

该API提供来自阿根廷主要超市的实时、SKU级别的杂货价格数据，数据已归一化为统一的JSON格式。

核心功能

• 产品搜索：支持按关键词跨零售商进行全文搜索。
• 条码价格对比：通过EAN条码，可跨零售商对比同一商品的价格，返回最低价、所有报价及价格统计信息（最小值、最大值、平均值、中位数、价差百分比）。
• 购物篮定价：支持对一组商品（最多20个EAN）或预设的“购物篮”进行定价，并对比不同零售商的总成本与覆盖情况。

覆盖范围

• 地区：拉丁美洲，以阿根廷为起点。
• 零售商：Coto、Carrefour、Jumbo、DIA、Vea、Disco、ChangoMás（原沃尔玛）。La Anónima、Rappi、PedidosYa在路线图中。

适用场景

• 消费品品牌：监控商品价格与竞品动态。
• 比价应用：集成实时价格比较功能。
• 金融科技：用于通胀追踪或价格分析。
• 研究人员/媒体：衡量通货膨胀和价格变化。

主要端点

端点	方法	功能描述
/v1/search	GET	跨零售商进行自由文本产品搜索。
/v1/retailers	GET	列出支持的零售商（活跃及路线图中的）。
/v1/prices	GET	根据EAN条码对比特定商品在不同零售商的价格，返回最低报价和统计。
/v1/basket	GET	根据提供的商品列表（EAN）或预设购物篮，计算各零售商的总价与覆盖情况。
/v1/baskets	GET	列出预设的购物篮列表（如 “canasta-basica-ar”）。

数据特征

• 实时性：从门店页面实时读取，默认有约15分钟缓存。
• 关键字段：商品名称、品牌、EAN条码、当前价格、原价、是否可购买、零售商信息、图片及商品页链接、获取时间戳。
• 错误处理：提供统一的错误响应格式，包括错误类型、消息和状态码（如400、403、429、502）。

使用方式

• 认证：需要在请求头中包含 X-RapidAPI-Key 和 X-RapidAPI-Host。
• 计费：通过RapidAPI平台提供四种订阅计划（BASIC、PRO、ULTRA、MEGA），详情见平台页面。

搜集汇总

背景与挑战

背景概述

该API提供来自阿根廷主要超市的实时SKU级杂货价格数据，支持产品搜索、跨零售商条形码对比以及整篮定价功能。