A API Winevybe fornece acesso abrangente e estruturado a um extenso catálogo de bebidas de diferentes tipos e categorias, permitindo que desenvolvedores e usuários explorem, pesquisem e filtrem produtos de forma eficiente. Com um total de 17.601 bebidas registradas, a API abrange uma ampla gama de categorias, incluindo cerveja, cidra, destilados, drinques mistos, opções não alcoólicas e vinhos, cada uma com quantidades específicas que refletem a diversidade da oferta: 986 cervejas, 132 cidras, 1.409 destilados, 104 drinques mistos, 180 produtos não alcoólicos e 14.790 vinhos. Isso garante que os usuários possam acessar tanto opções populares quanto produtos de nicho, variando de destilados premium e vinhos exclusivos a refrigerantes e misturas inovadoras.
A API é organizada em endpoints intuitivos que facilitam a interação e a recuperação de informações detalhadas. Por exemplo, você pode listar produtos por categoria, pesquisar bebidas por nome ou palavra-chave e acessar detalhes completos para cada bebida, incluindo informações como produtor, subcategoria, varietal, denominação, país de origem, safra, porcentagem de álcool, descrição, preços e links para imagens de alta qualidade. Isso permite que os usuários aprendam não apenas sobre as características de cada bebida, mas também visualizem e comparem facilmente os produtos.
Além disso, a API inclui dados robustos de paginação, permitindo navegação eficiente por listas extensas, e oferece informações sobre produtos relacionados para enriquecer a experiência do usuário e facilitar recomendações inteligentes. A API também mantém informações atualizadas sobre a data de sincronização, garantindo que os dados reflitam a disponibilidade de produtos mais recentes.
Em termos de usabilidade, a API é projetada para ser facilmente integrada a aplicações web, aplicações móveis e plataformas de e-commerce, oferecendo respostas rápidas e estruturadas em formato JSON que facilitam a manipulação de dados. Graças à sua ampla cobertura e à riqueza dos metadados fornecidos
Obtenha todas as categorias disponíveis e o número total de produtos em cada uma.
Este endpoint não requer parâmetros de entrada.
Testar endpoint
{"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'
Obtenha uma lista paginada de produtos (slugs) de uma categoria específica
Lista por categoria - Recursos do endpoint
| Objeto | Descrição |
|---|---|
category |
[Obrigatório] Indicate the name of a category, for example (beer, wine, liquor). |
page |
Opcional Indicate a page number (Default: 1). |
limit |
Opcional 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'
Pesquise por produtos que correspondam a um termo de busca Pesquise categorias de produtos e slugs
Buscar - Recursos do endpoint
| Objeto | Descrição |
|---|---|
q |
[Obrigatório] Enter a search term |
page |
Opcional Indicate a page number (Default: 1). |
limit |
Opcional 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'
Obtenha os detalhes completos de um produto específico usando seu slug. (O slug do produto pode ser obtido a partir de qualquer um dos dois endpoints anteriores.)
Detalhes por Slug - Recursos do endpoint
| Objeto | Descrição |
|---|---|
slug |
[Obrigatório] 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'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Cada endpoint retorna dados estruturados relacionados a bebidas O endpoint "GET Categories" fornece nomes de categorias e contagens de produtos O endpoint "GET List by category" retorna uma lista paginada de slugs de produtos dentro de uma categoria O endpoint "GET Search" retorna produtos que correspondem a um termo de pesquisa enquanto o "GET Details by Slug" fornece detalhes abrangentes sobre um produto específico incluindo seu título produtor e descrição
Os campos-chave variam conforme o endpoint Para "GET Categories" os campos incluem "categories" e "category_counts" O "GET List by category" inclui detalhes de "pagination" e "wines" O "GET Search" retorna "query" "count" e "results" O "GET Details by Slug" fornece campos como "title" "producer" "category" "alcohol" e "description" oferecendo informações detalhadas sobre o produto
A API retorna dados no formato JSON Cada resposta inclui um booleano "sucesso" seguido por campos de dados relevantes Por exemplo a resposta "GET Lista por categoria" inclui detalhes de paginação e um array de slugs de produtos A resposta "GET Detalhes por Slug" contém um objeto "metadados" e um objeto "produto" com atributos detalhados
O endpoint "GET Categorias" fornece categorias de bebidas e contagens de produtos O "GET Listar por categoria" oferece uma lista de produtos em uma categoria especificada O "GET Buscar" permite que os usuários encontrem produtos por termos de pesquisa O "GET Detalhes por Slug" fornece informações abrangentes sobre o produto incluindo descrições teor alcoólico e imagens
Os dados de resposta são organizados em objetos JSON estruturados. A resposta de cada endpoint inclui um campo "sucesso", seguido pelos dados relevantes. Por exemplo, o "GET Listar por categoria" organiza os dados em "paginação" e "vinhos", enquanto o "GET Detalhes por Slug" separa os detalhes de "metadados" e "produto", facilitando a análise e utilização
Os casos de uso típicos incluem a construção de catálogos de bebidas a realização de pesquisas de mercado e a gestão de inventário para varejistas Os desenvolvedores podem integrar a API em aplicativos para que os usuários possam pesquisar e explorar opções de bebidas As empresas podem analisar tendências de produtos e preferências dos consumidores com base nos dados detalhados fornecidos
Os usuários podem personalizar solicitações especificando parâmetros como categoria no endpoint "GET List by category" ou termos de busca no endpoint "GET Search" Parâmetros de paginação como "page" e "limit" também podem ser ajustados para controlar o número de resultados retornados permitindo a recuperação de dados personalizada
A precisão dos dados é mantida através de sincronizações e atualizações regulares de fontes confiáveis A API inclui um campo "last_synced_at" na resposta "GET Detalhes por Slug" indicando quando os dados foram atualizados pela última vez Isso garante que os usuários tenham acesso às informações mais atuais e precisas disponíveis
Nível de serviço:
100%
Tempo de resposta:
558ms
Nível de serviço:
100%
Tempo de resposta:
767ms
Nível de serviço:
33%
Tempo de resposta:
4.478ms
Nível de serviço:
33%
Tempo de resposta:
2.200ms
Nível de serviço:
100%
Tempo de resposta:
634ms
Nível de serviço:
33%
Tempo de resposta:
1.452ms
Nível de serviço:
67%
Tempo de resposta:
1.839ms
Nível de serviço:
33%
Tempo de resposta:
1.906ms
Nível de serviço:
100%
Tempo de resposta:
534ms
Nível de serviço:
100%
Tempo de resposta:
765ms
Nível de serviço:
100%
Tempo de resposta:
9.881ms
Nível de serviço:
100%
Tempo de resposta:
4.134ms
Nível de serviço:
100%
Tempo de resposta:
2.602ms
Nível de serviço:
100%
Tempo de resposta:
4.827ms
Nível de serviço:
100%
Tempo de resposta:
1.188ms
Nível de serviço:
100%
Tempo de resposta:
3.262ms
Nível de serviço:
100%
Tempo de resposta:
10.496ms
Nível de serviço:
100%
Tempo de resposta:
173ms
Nível de serviço:
100%
Tempo de resposta:
1.151ms
Nível de serviço:
100%
Tempo de resposta:
8.365ms