Vivino Wine Search API

Search wine ratings and details from a Vivino-backed wine database. Submit a wine name or product title and receive the best matching wine with score, review count, winery, grapes, vintage, price metadata, and source URL when available.

原始信息汇总

Vivino Wine Search API 数据集详情

数据集概述

该API提供基于Vivino葡萄酒数据库的搜索与结构化数据查询功能，主要用于将葡萄酒名称或产品标题与规范化葡萄酒数据进行匹配，返回包括酒庄、年份、评分、价格等在内的丰富元数据。

核心功能

• 葡萄酒搜索与发现：通过酒名、产品标题、年份、酒庄或葡萄品种查询。
• 产品目录增强：为零售或电商平台提供结构化葡萄酒数据。
• 葡萄酒评分查找：获取平均评分及评论数量。
• 酒庄与年份提取：从查询中提取并返回规范化元数据。
• 每瓶均价处理：提供平均价格及货币信息。

主要技术特征

特性	说明
API地址	https://rapidapi.com/vicxyz1/api/vivino-wine-search-api
当前版本	1.0.0
端点	GET /api/wine/search
认证方式	通过RapidAPI自动提供X-RapidAPI-Key和X-RapidAPI-Host头
查询参数	必需参数q（葡萄酒名称/酒庄/年份/产品标题）；可选高级参数包括force、no_cache、store、price、currency

数据响应格式

成功匹配时返回JSON对象，包含以下字段：

• name：规范化葡萄酒名称
• winery：生产商或酒庄名称
• year：年份（可用时）
• score：平均评分
• reviews：评论/评分数量
• url：来源葡萄酒页面链接
• avg_price：已知平均价格（可用时）
• currency：平均价格对应的货币代码（可用时）

响应行为

• 200 OK：返回葡萄酒对象（找到匹配）或空数组[]（未找到可信匹配）
• 400 Bad Request：请求无效（如缺少q参数或price非数字）
• 401 Unauthorized：API密钥缺失、无效或未激活
• 429 Too Many Requests：超出客户端速率限制
• 500 Internal Server Error：意外搜索错误

已知限制

• 仅返回单个最佳匹配结果，不提供排名列表。
• 若未找到可信匹配，返回空数组而非部分猜测列表。
• 部分字段（如year、avg_price、currency、url）可能为null或缺失。
• 评分、评论数量和价格数据依赖于源数据的时效性和可用性。
• 平均价格仅供信息参考，不应视为实时市场报价。
• 每客户端适用速率限制。

最佳实践建议

• 提交最清晰的产品标题，尽量包含酒庄和年份。
• 仅当葡萄品种真正属于葡萄酒身份标识时再包含。
• 将avg_price视为增强元数据，而非结算价格。
• 处理两种成功响应形态：葡萄酒对象或空数组。

提供商信息

• 创建者：vicxyz1
• 订阅人数：1
• 类别：Food（食品）
• 提供条款：使用条款需联系提供商获取