Quick start
curl https://vinndex.com.ar/api/v1/search?q=malbec | jq
Endpoints
- GET
/api/v1/wine/{slug}Info completa de un vino + offers de cada vinoteca + scores de críticos.
GET /api/v1/wine/felicien-malbec-saint ↗ - GET
/api/v1/search?q={query}Búsqueda de vinos con filtros (varietal, region, type, multi, instock, priceMin, priceMax, sort, limit).
GET /api/v1/search?q=malbec&priceMax=10000&sort=score-desc&limit=10 ↗ - GET
/api/v1/storesLista de las vinotecas relevadas con su slug, nombre y productCount.
GET /api/v1/stores ↗ - GET
/api/v1/rankingsLista de rankings disponibles (top-malbecs-baratos, top-espumantes, etc.).
GET /api/v1/rankings ↗ - GET
/api/v1/rankings/{slug}Items de un ranking específico, ordenados.
GET /api/v1/rankings/top-malbecs-baratos ↗ - GET
/api/price-dropsLista de price drops del día. Mismo data que la sección 'Bajaron de precio' de la home.
GET /api/price-drops ↗
Casos de uso
Buscar Malbec barato con stock
GET /api/v1/search?q=malbec&priceMax=10000&instock=1&sort=price-asc
Pedirle a un agente IA el mejor precio de un vino específico
GET /api/v1/wine/felicien-malbec-saint # Devuelve el array offers[] con cada precio + storeName + url
Listar todos los price drops del día
GET /api/price-drops # Devuelve top 50 drops con dropPct y medianPrice7d
Top espumantes según el ranking curado
GET /api/v1/rankings/top-espumantes
Política de uso
- · Sin auth, sin rate limit estricto. Pedimos que seas razonable — cache local cuando puedas, respetá los headers de
cache-controlque mandamos (5 min en cliente / 15 min en edge). - · CORS abierto:
access-control-allow-origin: *. Podés llamarla directamente desde el browser sin proxy. - · Datos actualizados a diario con el snapshot de las 03:00 ART. Si tu app necesita stock real-time, llamá a la tienda directamente con el
urlque devolvemos enoffers[]. - · Atribución: si lo usás en producción, ponele un “Datos de Vinndex” con link a vinndex.com.ar. No es obligatorio pero ayuda.
- · Sin garantías. La API es free como cortesía al ecosistema. Si necesitás SLA, hablemos por contacto.
Versión: v1 · Si rompemos compat haremos v2 sin afectar v1 durante un período razonable (≥3 meses).
Encontrás un bug, te falta un endpoint o querés cambiar el shape de algo → contacto.