Winevybe API 提供全面、结构化的访问,以便高效地探索、搜索和过滤各种类型和类别的饮料,开发者和用户能够充分利用这一点。注册的饮料总数为 17,601 种,API 涵盖了广泛的类别,包括啤酒、苹果酒、烈酒、混合饮料、非酒精产品和葡萄酒,每个类别都有反映其多样性的具体数量:986 种啤酒、132 种苹果酒、1,409 种烈酒、104 种混合饮料、180 种非酒精产品和 14,790 种葡萄酒。这确保用户可以访问畅销选项和小众产品,从高档烈酒和独家葡萄酒到软饮料和创新混合饮料。
API 被组织成直观的端点,以便利交互和详细信息的检索。例如,您可以按类别列出产品,通过名称或关键词搜索饮料,并获取每种饮料的完整详细信息,包括生产商、子类别、品种、产区、原产国、年份、酒精浓度、描述、价格和高质量图片的链接。这不仅使用户了解每种饮料的特性,还能轻松查看和比较产品。
此外,API 包含强大的分页数据,允许高效浏览庞大的列表,并提供相关产品的信息,以丰富用户体验和促进智能推荐。API 还保持最新的同步日期信息,确保数据反映最新的产品可用性。
在可用性方面,API 设计为易于集成到网络应用、移动应用和电子商务平台中,提供快速、结构化的 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/11364/winevybe+api/21525/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/11364/winevybe+api/21526/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/11364/winevybe+api/21527/search?q=wine&page=1&limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
使用产品的标识获取特定产品的完整详细信息 (产品标识可以从之前的两个端点中的任一个获取)
错误 - 端点功能
| 对象 | 描述 |
|---|---|
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/11364/winevybe+api/21528/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” 提供特定产品的综合细节,包括其标题、生产者和描述
关键字段因端点而异 对于“获取类别”,字段包括“类别”和“类别计数” “按类别获取列表”包括“分页”细节和“葡萄酒” “获取搜索”返回“查询”“计数”和“结果” “通过Slug获取详细信息”提供字段如“标题”“生产者”“类别”“酒精”“描述”提供深入的产品信息
API以JSON格式返回数据 每个响应包含一个"success"布尔值,后面跟着相关数据字段 例如"按类别获取列表"的响应包括分页细节和一个产品slug的数组 "按Slug获取详情"的响应包含一个"metadata"对象和一个带有详细属性的"product"对象
“获取类别”端点提供饮料类别和产品数量 “按类别获取列表”提供指定类别中的产品列表 “搜索获取”允许用户通过搜索词查找产品 “通过别名获取详细信息”提供全面的产品信息,包括描述 酒精含量和图片
响应数据被组织为结构化的 JSON 对象 每个端点的响应包含一个“success”字段,后面跟着相关数据 例如“按类别获取列表”将数据组织为“分页”和“葡萄酒”而“按别名获取详情”则将“元数据”和“产品”详情分开,使其易于解析和使用
典型的用例包括建立饮料目录 进行市场研究 以及为零售商管理库存 开发者可以将API集成到应用程序中以便用户搜索和探索饮料选项 企业可以根据提供的详细数据分析产品趋势和消费者偏好
用户可以通过在“按类别获取列表”端点中指定类别等参数,或在“获取搜索”端点中指定搜索词来定制请求。分页参数如“页”和“限制”也可以调整,以控制返回的结果数量,从而实现定制的数据检索
通过定期从可靠来源进行同步和更新来保持数据的准确性 API在“根据别名获取详细信息”的响应中包含一个“last_synced_at”字段,指示数据最后一次刷新的时间 这确保用户访问到目前为止最新和最准确的信息
Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]
此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
22ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms