Wine API 提供全面、结构化的访问,涵盖不同类型和类别的大量饮品目录,使开发者和用户能够高效地探索、搜索和过滤产品。该 API 注册的饮品总数为 17,601,包括啤酒、苹果酒、烈酒、混合饮料、非酒精饮品和葡萄酒等多个类别,各类饮品的具体数量反映了提供产品的多样性:986 种啤酒、132 种苹果酒、1,409 种烈酒、104 种混合饮料、180 种非酒精产品和 14,790 种葡萄酒。这确保用户可以访问到流行的选择和小众产品,从高端烈酒和独特葡萄酒到软饮和创新混合饮品。
API 组织成直观的端点,便于交互和详细信息的检索。例如,您可以按类别列出产品,通过名称或关键字搜索饮品,并访问每种饮品的完整详细信息,包括生产商、子类别、品种、产区、原产国、年份、酒精百分比、描述、价格和高质量图片的链接。这使得用户不仅可以了解每种饮品的特点,还可以轻松查看和比较产品。
此外,API 包含强大的分页数据,允许有效浏览大量列表,并提供相关产品的信息,以丰富用户体验并促进智能推荐。API 还保持最新的同步日期信息,确保数据反映最新的产品可用性。
在可用性方面,API 旨在易于集成到Web应用程序、移动应用程序和电子商务平台,提供快速、结构化的 JSON 格式响应,便于数据处理。得益于其广泛的覆盖范围和提供的丰富元数据
{"success":true,"count":6,"total":17601,"categories":["beer","cider","liquor","mixed-drinks","non-alcoholic","wine"],"category_counts":{"beer":986,"cider":132,"liquor":1409,"mixed-drinks":104,"non-alcoholic":180,"wine":14790}}
curl --location --request GET 'https://zylalabs.com/api/11315/wine+api/21452/categories' --header 'Authorization: Bearer YOUR_API_KEY'
按类别列出 - 端点功能
| 对象 | 描述 |
|---|---|
category |
[必需] Indicate the name of a category, for example (beer, wine, liquor). |
page |
可选 Indicate a page number (Default: 1). |
limit |
可选 Indicate the number of products per page (Default: 20, Maximum: 50). |
{"success":true,"category":"wine","pagination":{"page":1,"limit":20,"total":14790,"totalPages":740,"hasNextPage":true,"hasPreviousPage":false},"wines":["19-crimes-cabernet-sauvignon","19-crimes-hard-chardonnay-750ml","19-crimes-red-blend","19-crimes-shiraz","19-crimes-the-magistrate-shiraz","3-drops-pinot-noir-2017","3-drops-riesling","3-hectares-feteasca-neagra-black-maiden","4-kilos-vinicola-gallinas-y-focas","4-monos-madrid-tinto-gr-10-2018","42-degrees-south-pinot-noir","6ft6-chardonnay","6ft6-pinot-gris","6ft6-pinot-noir","6ft6-prosecco","6ft6-rose","6ft6-sauvignon-blanc","6ft6-shiraz","99-in-the-shade-cabernet-sauvingon","99-in-the-shade-chardonnay"]}
curl --location --request GET 'https://zylalabs.com/api/11315/wine+api/21453/list+by+category?category=wine&page=1&limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
搜索匹配搜索词的产品 搜索产品类别和标识符
搜索 - 端点功能
| 对象 | 描述 |
|---|---|
q |
[必需] Enter a search term |
page |
可选 Indicate a page number (Default: 1). |
limit |
可选 Indicate the number of products per page (Default: 20, Maximum: 50). |
{"success":true,"query":"wine","count":14818,"pagination":{"page":1,"limit":20,"total":14818,"totalPages":741,"hasNextPage":true,"hasPreviousPage":false},"results":[{"slug":"19-crimes-cabernet-sauvignon","category":"wine"},{"slug":"19-crimes-hard-chardonnay-750ml","category":"wine"},{"slug":"19-crimes-red-blend","category":"wine"},{"slug":"19-crimes-shiraz","category":"wine"},{"slug":"19-crimes-the-magistrate-shiraz","category":"wine"},{"slug":"3-drops-pinot-noir-2017","category":"wine"},{"slug":"3-drops-riesling","category":"wine"},{"slug":"3-hectares-feteasca-neagra-black-maiden","category":"wine"},{"slug":"4-kilos-vinicola-gallinas-y-focas","category":"wine"},{"slug":"4-monos-madrid-tinto-gr-10-2018","category":"wine"},{"slug":"42-degrees-south-pinot-noir","category":"wine"},{"slug":"6ft6-chardonnay","category":"wine"},{"slug":"6ft6-pinot-gris","category":"wine"},{"slug":"6ft6-pinot-noir","category":"wine"},{"slug":"6ft6-prosecco","category":"wine"},{"slug":"6ft6-rose","category":"wine"},{"slug":"6ft6-sauvignon-blanc","category":"wine"},{"slug":"6ft6-shiraz","category":"wine"},{"slug":"99-in-the-shade-cabernet-sauvingon","category":"wine"},{"slug":"99-in-the-shade-chardonnay","category":"wine"}],"slugs":["19-crimes-cabernet-sauvignon","19-crimes-hard-chardonnay-750ml","19-crimes-red-blend","19-crimes-shiraz","19-crimes-the-magistrate-shiraz","3-drops-pinot-noir-2017","3-drops-riesling","3-hectares-feteasca-neagra-black-maiden","4-kilos-vinicola-gallinas-y-focas","4-monos-madrid-tinto-gr-10-2018","42-degrees-south-pinot-noir","6ft6-chardonnay","6ft6-pinot-gris","6ft6-pinot-noir","6ft6-prosecco","6ft6-rose","6ft6-sauvignon-blanc","6ft6-shiraz","99-in-the-shade-cabernet-sauvingon","99-in-the-shade-chardonnay"]}
curl --location --request GET 'https://zylalabs.com/api/11315/wine+api/21454/search?q=wine&page=1&limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
使用产品的缩略名获取特定产品的完整详细信息(产品缩略名可以从前两个端点中的任一个获取)
细节通过Slug - 端点功能
| 对象 | 描述 |
|---|---|
slug |
[必需] Enter a slug |
{"success":true,"metadata":{"last_synced_at":"2025-11-19T02:37:35+00:00"},"product":{"id":21292,"sku":"WVB-115189","title":"19 Crimes Cabernet Sauvignon","producer":"19 Crimes","category":"wine","subcategory":"Wine","varietal":"Cabernet Sauvignon","appellation":null,"country":null,"vintage":null,"alcohol":13.5,"image_url":"https://winevybe.com/media/assets/19-Crimes-Cabernet-Sauvignon.png","description":"The 19 Crimes Cabernet Sauvignon is a bold and robust red wine that hails from the renowned wine regions of Australia. Crafted from carefully selected Cabernet Sauvignon grapes, this wine boasts a deep ruby color and a complex flavor profile. On the nose, expect to find aromas of dark berries, cassis, and hints of oak. The palate is rich and full-bodied, with flavors of blackcurrant, plum, and subtle notes of vanilla and spice. This wine is well-structured with firm tannins and a long, lingering finish. Ideal for pairing with hearty dishes such as grilled meats or aged cheeses, the 19 Crimes Cabernet Sauvignon is a versatile wine that can also be enjoyed on its own. With its balanced acidity and smooth texture, this wine is sure to please both casual drinkers and connoisseurs alike. Whether you're looking for a wine to savor on a special occasion or simply unwind after a long day, the 19 Crimes Cabernet Sauvignon offers an exceptional drinking experience that captures the essence of Australian winemaking at its finest.","pricing":{"currency":"USD","amount":0,"formatted":"$0.00"}},"related_products":[{"id":24983,"sku":"WVB-102896","title":"19 Crimes Red Blend"},{"id":22293,"sku":"WVB-100075","title":"19 Crimes Hard Chardonnay"},{"id":26904,"sku":"WVB-105729","title":"19 Crimes Shiraz"},{"id":27138,"sku":"WVB-105872","title":"19 Crimes The Magistrate Shiraz"},{"id":3572,"sku":"WVB-107076","title":"Château Mouton Rothschild Château Mouton Rothschild 1964","price":{"currency":"USD","amount":565,"formatted":"$565.00"}},{"id":10901,"sku":"WVB-100962","title":"Rosily Vineyard Merlot"},{"id":1690,"sku":"WVB-108281","title":"Domaine Leroy Clos de Vougeot 1990","price":{"currency":"USD","amount":2981,"formatted":"$2,981.00"}},{"id":21244,"sku":"WVB-115157","title":"Rolf Binder Barossa Cabernet Sauvignon"},{"id":11978,"sku":"WVB-106415","title":"Rey del Mundo Rioja Tempranillo"}]}
curl --location --request GET 'https://zylalabs.com/api/11315/wine+api/21455/details+by+slug?slug=19-crimes-cabernet-sauvignon' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
每个端点返回与饮料相关的结构化数据 "获取类别" 端点提供类别名称和产品数量 "按类别获取列表" 返回特定类别内产品的分页列表 "获取搜索" 端点返回匹配搜索词的产品 "按短链接获取详情" 提供关于特定产品的详细信息,包括标题 制造商和描述
关键字段因端点而异 对于“获取类别”,字段包括“类别”和“类别计数” “按类别获取列表”包括“分页”详情和“葡萄酒” “获取搜索”返回“查询”“计数”和“结果” “按别名获取详细信息”提供如“标题”“生产商”“类别”“酒精”“描述”等字段,提供深入的产品信息
API以JSON格式返回数据 每个响应包含一个"success"布尔值,以及相关数据字段 例如"按类别获取列表"响应包含分页细节和一个产品slug数组 "按slug获取详情"响应包含一个"metadata"对象和一个"product"对象及详细属性
“获取类别”端点提供饮料类别和产品数量 “按类别获取列表”提供指定类别的产品列表 “搜索获取”允许用户通过搜索词查找产品 “通过Slug获取详细信息”提供全面的产品信息,包括描述 酒精含量和图片
响应数据组织为结构化的 JSON 对象 每个端点的响应包含一个 "success" 字段,后面是相关数据 例如 "按类别获取列表" 将数据组织为 "分页" 和 "葡萄酒",而 "按 Slug 获取详细信息" 则将 "元数据" 和 "产品" 详细信息分开,便于解析和利用
典型的使用案例包括建立饮品目录 进行市场研究 和管理零售商的库存 开发者可以将API集成到应用程序中 让用户搜索和探索饮品选项 企业可以根据提供的详细数据分析产品趋势和消费者偏好
用户可以通过在“按类别获取列表”端点中指定参数如类别或在“获取搜索”端点中指定搜索词来定制请求 分页参数如“页面”和“限制”也可以调整以控制返回的结果数量,从而实现量身定制的数据检索
数据准确性通过定期从可靠来源同步和更新来保持 API在“按标识符获取详细信息”的响应中包含“last_synced_at”字段,指示数据最后刷新的时间 这确保用户访问最新和最准确的信息
服务级别:
100%
响应时间:
765ms
服务级别:
100%
响应时间:
135ms
服务级别:
100%
响应时间:
198ms
服务级别:
100%
响应时间:
221ms
服务级别:
100%
响应时间:
17,671ms
服务级别:
100%
响应时间:
50ms
服务级别:
100%
响应时间:
886ms
服务级别:
100%
响应时间:
787ms
服务级别:
100%
响应时间:
9,480ms
服务级别:
100%
响应时间:
346ms
服务级别:
100%
响应时间:
17,305ms
服务级别:
100%
响应时间:
355ms
服务级别:
100%
响应时间:
358ms
服务级别:
100%
响应时间:
3,224ms
服务级别:
100%
响应时间:
724ms
服务级别:
100%
响应时间:
303ms
服务级别:
100%
响应时间:
128ms
服务级别:
100%
响应时间:
2,774ms
服务级别:
100%
响应时间:
525ms
服务级别:
100%
响应时间:
2,518ms