US Fruit and Vegetable Prices

A comprehensive data API providing the latest average retail prices, yields, and cup equivalent metrics for a wide variety of fresh, frozen, canned, and dried fruits and vegetables in the US.

原始信息汇总

US Fruit and Vegetable Prices 数据集概述

数据集基本信息

• 数据集名称：US Fruit and Vegetable Prices
• 提供平台：RapidAPI
• API 版本：1.0.0 (current)
• 类别：Food
• 提供者：Matyi Kari
• 订阅者数量：1
• 受欢迎度评分：8.7 Popularity
• 服务等级：100% Service Level
• 延迟：165ms Latency
• 测试覆盖率：100% Test

数据来源与描述

• 数据来源：USDA, Economic Research Service (ERS) 使用 Circana 的零售扫描数据计算得出。
• 数据收集范围：美国各地的零售机构（杂货店、超市、大型超市、便利店、药店和酒类商店）每周的零售销售数据（收入和数量）。
• 数据内容：提供美国各种新鲜、冷冻、罐装和干制水果和蔬菜的最新平均零售价格、产量和杯当量指标的综合数据。
• 应用场景：对营养师、食品成本计算器、杂货应用和农业研究人员非常有用。

订阅计划与定价

• BASIC：$0.00 / 月
• PRO：$19.99 / 月
• ULTRA：$79.99 / 月
• MEGA：$299.99 / 月

API 端点

1. 获取所有水果

• 方法：GET
• 端点：/fruits
• 描述：检索水果价格和指标的完整数据集。

2. 按名称搜索水果

• 方法：GET
• 端点：/fruits/{name}
• 路径参数：
  • name (字符串，必需)：要搜索的水果名称（例如，apples, bananas, berries）。
• 描述：基于部分或完全文本匹配搜索特定水果。

3. 获取所有蔬菜

• 方法：GET
• 端点：/vegetables
• 描述：检索蔬菜价格和指标的完整数据集。

4. 按名称搜索蔬菜

• 方法：GET
• 端点：/vegetables/{name}
• 路径参数：
  • name (字符串，必需)：要搜索的蔬菜名称（例如，carrots, spinach, beans）。
• 描述：基于部分或完全文本匹配搜索特定蔬菜。

认证方式

• 认证由 RapidAPI 自动处理。
• 必须在每个请求的头部包含唯一的 RapidAPI 密钥：
  • X-RapidAPI-Key: Your API Key
  • X-RapidAPI-Host: us-fruit-and-vegetable-prices.p.rapidapi.com

响应格式

• 所有端点返回完全相同 JSON 结构的数据。
• 成功请求将返回 200 OK 状态，包含一个 count 整数和一个包含匹配项的 data 数组。

示例响应

json { "count": 1, "data": [ { "Fruit": "Apples", "Form": "Fresh", "AverageRetailPrice": "1.86093095", "AverageRetailPriceUnitOfMeasure": "per pound", "PreparationYieldFactor": "0.9", "SizeOfACupEquivalent": "0.2425", "CupEquivalentUnitOfMeasure": "pounds", "AveragePricePerCupEquivalent": "0.501435057" } ] }

（注意：如果查询蔬菜端点，"Fruit" 键将替换为 "Vegetable"。）

数据字典

字段	类型	描述
Fruit / Vegetable	string	农产品名称。
Form	string	制备或储存形式（例如，Fresh, Canned, Frozen, Dried, Juice）。
AverageRetailPrice	string	以美元计的平均零售价格。
AverageRetailPriceUnitOfMeasure	string	零售价格的计量单位（例如，per pound, per pint）。
PreparationYieldFactor	string	制备后的可用产量因子（例如，去除果皮/果核后）。
SizeOfACupEquivalent	string	等于一个营养杯当量的制备产品量。
CupEquivalentUnitOfMeasure	string	杯当量的计量单位（例如，pounds, pints）。
AveragePricePerCupEquivalent	string	以美元计的每杯当量计算平均价格。