A API fornece um sistema abrangente e estruturado para acessar informações sobre uma ampla gama de bebidas, incluindo cervejas, vinhos, destilados, cidras, misturadores e opções não alcoólicas. Seu design permite que os usuários consultem dados categorizados, listem produtos por tipo, realizem buscas específicas e obtenham detalhes precisos sobre cada bebida usando seu identificador único ou "slug". Cada produto contém informações detalhadas, como título, produtor, categoria, subcategoria, varietal, país de origem, safra, teor alcoólico, descrição textual, preços e links para imagens.
Entre suas características está a capacidade de contar produtos de acordo com critérios específicos, o que facilita a análise e filtragem de dados. Por exemplo, você pode contar todos os produtos de um determinado ano e mês que pertencem a uma categoria específica e têm dados completos nos campos selecionados. Isso é especialmente útil para relatórios de negócios, inventários e pesquisas de mercado.
A API também suporta paginação, permitindo acesso eficiente a grandes volumes de informações sem sobrecarregar a resposta. Os resultados podem incluir listas de produtos por categoria, mostrando um número limitado por página e fornecendo informações sobre páginas anteriores ou seguintes. Além disso, cada produto pode ter produtos relacionados, permitindo que os usuários descubram opções semelhantes ou complementares e construam relações entre diferentes itens.
Cada bebida é acompanhada de descrições detalhadas que incluem características organolépticas, história, processo de produção e recomendações de consumo. Os preços podem ser apresentados em diferentes formatos e moedas, e informações sobre a última sincronização de dados são fornecidas, garantindo que as informações estejam atualizadas.
No geral, esta API é uma ferramenta robusta para desenvolvedores, varejistas, distribuidores e entusiastas de bebidas, pois fornece acesso centralizado a informações confiáveis, filtráveis e abrangentes que podem ser integradas em aplicativos web ou móveis e são úteis tanto para consumo de dados individuais quanto para análise em massa de inventário e tendências de mercado.
Obtém todas as categorias disponíveis e o número total de produtos em cada uma
{"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'
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/11315/wine+api/21453/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
Pesquisar - 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/11315/wine+api/21454/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 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/11315/wine+api/21455/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 ponto de extremidade retorna dados estruturados relacionados a bebidas O ponto de extremidade "GET Categories" fornece nomes de categorias e contagens de produtos O ponto de extremidade "GET List by category" retorna uma lista paginada de slugs de produtos dentro de uma categoria O ponto de extremidade "GET Search" retorna produtos que correspondem a um termo de busca enquanto o ponto de extremidade "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 ponto de extremidade 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 "success" seguido de campos de dados relevantes Por exemplo a resposta "GET List by category" inclui detalhes de paginação e um array de slugs de produtos A resposta "GET Details by Slug" contém um objeto "metadata" e um objeto "product" com atributos detalhados
A endpoint "GET Categorias" fornece categorias de bebidas e contagem de produtos A "GET Lista por categoria" oferece uma lista de produtos em uma categoria especificada A "GET Busca" permite que os usuários encontrem produtos por termos de busca A "GET Detalhes por Slug" entrega 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 Cada resposta de endpoint inclui um campo "sucesso" seguido pelos dados relevantes Por exemplo o "GET Lista por categoria" organiza os dados em "paginaçao" e "vinhos" enquanto o "GET Detalhes por Slug" separa detalhes de "metadados" e "produto" tornando fácil de analisar e utilizar
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 os usuários pesquisarem e explorarem 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 Details by Slug" indicando quando os dados foram atualizados pela última vez Isso garante que os usuários acessem as 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:
100%
Tempo de resposta:
17.731ms
Nível de serviço:
33%
Tempo de resposta:
1.452ms
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:
4.478ms
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:
765ms
Nível de serviço:
100%
Tempo de resposta:
238ms
Nível de serviço:
100%
Tempo de resposta:
1.320ms
Nível de serviço:
100%
Tempo de resposta:
3.519ms
Nível de serviço:
100%
Tempo de resposta:
764ms
Nível de serviço:
100%
Tempo de resposta:
6.234ms
Nível de serviço:
100%
Tempo de resposta:
801ms
Nível de serviço:
100%
Tempo de resposta:
2.507ms
Nível de serviço:
100%
Tempo de resposta:
7.153ms
Nível de serviço:
100%
Tempo de resposta:
1.249ms
Nível de serviço:
100%
Tempo de resposta:
1.154ms