Liquor API提供全面、结构化的访问,涵盖了各种类型和类别的广泛饮品目录,使开发者和用户能够高效地探索、搜索和筛选产品。注册的饮品总数为17,601种,API覆盖了广泛的类别,包括啤酒、苹果酒、烈酒、混合饮料、无酒精选项和葡萄酒,每种类别都有反映多样性的特定数量: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/11361/liquor+api/21505/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/11361/liquor+api/21511/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/11361/liquor+api/21519/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/11361/liquor+api/21524/details+by+slug?slug=19-crimes-cabernet-sauvignon' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
每个端点返回与饮料相关的结构化数据 "GET Categories" 端点提供类别名称和产品数量 "GET List by category" 返回一个包含类别内产品缩略词的分页列表 "GET Search" 端点返回匹配搜索词的产品 "GET Details by Slug" 提供关于特定产品的详细信息,包括其标题 制造商和描述
关键字段因端点而异 对于“获取分类”,字段包括“分类”和“分类计数” “按类别获取列表”包括“分页”详细信息和“葡萄酒” “获取搜索”返回“查询”、“计数”和“结果” “按缩略词获取详细信息”提供字段如“标题”、“生产者”、“类别”、“酒精含量”和“描述”,提供深入的产品信息
API 返回 JSON 格式的数据 每个响应包括一个 "success" 布尔值 后面是相关的数据字段 例如 "按类别获取列表" 响应包括分页详细信息和一个产品 slug 数组 "按 slug 获取详细信息" 响应包含一个 "metadata" 对象和一个 "product" 对象以及详细属性
“获取类别”端点提供饮料类别和产品数量 “按类别获取列表”提供指定类别的产品列表 “搜索获取”允许用户通过搜索词查找产品 “通过友好地址获取详细信息”提供全面的产品信息,包括描述、酒精含量和图片
响应数据被组织成结构化的 JSON 对象。每个端点的响应包括一个“success”字段,后面跟着相关数据。例如,“按类别获取列表”将数据组织为“分页”和“葡萄酒”,而“按别名获取详情”则将“元数据”和“产品”详情分开,便于解析和利用
典型的用例包括建立饮料目录 进行市场研究 和管理零售商的库存 开发人员可以将API集成到应用程序中 让用户搜索和探索饮料选项 企业可以根据提供的详细数据分析产品趋势和消费者偏好
用户可以通过在“按类别获取列表”端点中指定类别或在“获取搜索”端点中指定搜索词来自定义请求。分页参数如“页”和“限制”也可以调整以控制返回结果的数量,从而实现定制的数据检索
数据准确性通过从可靠来源定期同步和更新来维护 API 在“通过 Slug 获取详细信息”的响应中包括一个“last_synced_at”字段,指示数据最后一次刷新时的时间 这确保用户可以访问到最新和最准确的信息
服务级别:
100%
响应时间:
534ms
服务级别:
100%
响应时间:
135ms
服务级别:
100%
响应时间:
198ms
服务级别:
100%
响应时间:
221ms
服务级别:
100%
响应时间:
17,671ms
服务级别:
100%
响应时间:
50ms
服务级别:
100%
响应时间:
886ms
服务级别:
100%
响应时间:
787ms
服务级别:
100%
响应时间:
9,480ms
服务级别:
100%
响应时间:
346ms