A API Liquor oferece 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 17601 bebidas registradas, a API abrange uma ampla gama de categorias, incluindo cerveja, sidra, destilados, coquetéis, opções não alcoólicas e vinhos, cada uma com quantidades específicas que refletem a diversidade da oferta: 986 cervejas, 132 sidras, 1409 destilados, 104 coquetéis, 180 produtos não alcoólicos e 14790 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 de 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 não apenas conheçam as características de cada bebida, mas também visualizem e comparem produtos facilmente
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 recente
Em termos de usabilidade, a API foi projetada para ser facilmente integrada em aplicativos web, aplicativos móveis e plataformas de comércio eletrônico, 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.
{"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'
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/11361/liquor+api/21511/list+by+category?category=wine&page=1&limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
Procure 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/11361/liquor+api/21519/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 em 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/11361/liquor+api/21524/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 de acordo com 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 do 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 produto A resposta "GET Detalhes por Slug" contém um objeto "metadados" e um objeto "produto" com atributos detalhados
O endpoint "GET Categories" fornece categorias de bebidas e contagem de produtos O "GET List by category" oferece uma lista de produtos em uma categoria especificada O "GET Search" permite que os usuários encontrem produtos por termos de busca O "GET Details by Slug" entrega informações abrangentes sobre o produto incluindo descrições conteúdo alcoólico e imagens
Os dados de resposta estão organizados em objetos JSON estruturados. A resposta de cada endpoint inclui um campo "sucesso", seguido pelos dados relevantes. Por exemplo, o "GET List by category" organiza os dados em "paginação" e "vinhos", enquanto o "GET Details by Slug" separa os detalhes de "metadados" e "produto", facilitando a análise e utilização
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 pesquisem e explorem 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 pesquisa 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 uma recuperação de dados personalizada
A precisão dos dados é mantida por meio 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 tenham acesso às informações mais atuais e precisas disponíveis
Nível de serviço:
100%
Tempo de resposta:
198ms
Nível de serviço:
100%
Tempo de resposta:
135ms
Nível de serviço:
100%
Tempo de resposta:
534ms
Nível de serviço:
100%
Tempo de resposta:
221ms
Nível de serviço:
100%
Tempo de resposta:
50ms
Nível de serviço:
100%
Tempo de resposta:
17.671ms
Nível de serviço:
100%
Tempo de resposta:
116ms
Nível de serviço:
100%
Tempo de resposta:
346ms
Nível de serviço:
100%
Tempo de resposta:
886ms
Nível de serviço:
100%
Tempo de resposta:
56ms
Nível de serviço:
100%
Tempo de resposta:
830ms
Nível de serviço:
100%
Tempo de resposta:
1.680ms
Nível de serviço:
100%
Tempo de resposta:
1.814ms
Nível de serviço:
100%
Tempo de resposta:
916ms
Nível de serviço:
100%
Tempo de resposta:
1.658ms
Nível de serviço:
100%
Tempo de resposta:
1.834ms
Nível de serviço:
100%
Tempo de resposta:
3.709ms
Nível de serviço:
100%
Tempo de resposta:
300ms
Nível de serviço:
100%
Tempo de resposta:
329ms
Nível de serviço:
75%
Tempo de resposta:
1.498ms