Partners · API pública v1

La Identidad Digital del vino

Identidad auténtica, única y portable. Construida una vez por la bodega, servida gratis a cualquier carta digital, distribuidor, blog o e-commerce del sector.

⚡ Ver en acción

Esto es un widget de SommelierLab dentro de esta página →

Renderizado en vivo. El mismo que aparecerá en cualquier blog o web que pegue 2 líneas de código.

Variante "card" (default)

<sommelierlab-wine id="V057-2024">
</sommelierlab-wine>

Variante "bottle" (solo foto)

<sommelierlab-wine id="V057-2024"
  variant="bottle">
</sommelierlab-wine>

Script común para ambas variantes (1 vez por página):

<script src="https://sommelierlab-dashboard.vercel.app/embed.js" async></script>

· Auto-resize sin scroll · CORS abierto · sin token
· Click en card / botella → modal full-screen con ficha QR2 (audio + sommelier IA + cata)
· Atribución muy sutil (sommelierlab.com en gris) · obligatoria

⚙️ Modo trigger

¿Tienes tu propia card / botón / diseño?

Construye tu UI como quieras. Al click, llamas a la API y abrimos el modal con la ficha SommelierLab encima.

Snippet

<script
  src="https://sommelierlab-dashboard.vercel.app/embed.js"
  async></script>

<!-- Tu botón / card / imagen — con tu diseño -->
<button onclick="SommelierLab.open('V057-2024')">
  Ver ficha
</button>

<!-- O con tu propia card visual -->
<div onclick="SommelierLab.open('V057-2024')">
  <img src="mi-foto-botella.jpg" />
  <h3>Mi diseño de carta digital</h3>
</div>

API JavaScript

// Abrir modal con ficha
SommelierLab.open("V057-2024");

// Con idioma específico
SommelierLab.open({
  id: "V057-2024",
  lang: "ca"
});

// Cerrar programáticamente
SommelierLab.close();

Cuando llamas a SommelierLab.open(), creamos un overlay fullscreen con la ficha real del QR2 (audio, sommelier IA, cata, premios). El consumidor cierra y vuelve a tu web sin haberla abandonado. Toda la analítica cae en el dashboard del bodeguero.

¿Cuándo usar trigger vs custom element? Usa <sommelierlab-wine> si no tienes diseño propio y quieres todo hecho (blogs, WordPress básicos). Usa SommelierLab.open() si tu sitio tiene su propio look & feel (cartas digitales, e-commerces, distribuidores) y solo quieres añadir la experiencia rica al click.

Si prefieres API JSON pura (sin widget)

Sin registro. Sin API key. CORS abierto.

curl https://sommelierlab-dashboard.vercel.app/api/public/v1/wines/V057/2024

Devuelve

· Narrativa premium multilingüe (es, ca, en, fr, de, it)
· Audio narrado por voz humana
· Cata organoléptica estructurada
· Maridajes validados por la bodega
· Premios y certificados
· Sommelier IA agent_id (ElevenLabs)
· URLs de compra + mercados
· Embed URL + QR1 legal EU 2117
· Thumbnail oficial + tema visual

Atribución obligatoria

<a href="https://sommelierlab.com">
  Powered by SommelierLab
</a>

¿Volumen alto o sin atribución? Hablamos.

🍷 Para bodegas

La Identidad Digital · incluida en Bottle

Si tu vino está en SommelierLab, su identidad digital es portable. Cualquier carta digital, e-commerce o blog puede integrar tu ficha premium gratis. Sin trabajo extra. Sin pagar de nuevo.

·API JSON pública de tu vino
·Widget JS embebible con 2 líneas
·Modal con tu ficha premium completa
·Analítica cross-canal en tu dashboard
·Sin coste adicional al Bottle que ya pagas

Ver SommelierLab Bottle →

⚙️ Para integradores

API + Widget · gratis

¿Carta digital · e-commerce · blog · ERP HORECA? Integra los datos premium de cualquier vino de nuestro catálogo. Sin registro, sin token, sin coste. Solo necesitas mostrar la atribución sommelierlab.com.

·CORS abierto · sin API key
·JSON estable v1 + widget JS de 2 líneas
·Atribución obligatoria visible
·¿Casos especiales? (volumen, white-label, custom) hablamos

Hablamos · hola@sommelierlab.com

La portabilidad de la Identidad Digital está incluida en SommelierLab Bottle. Cuando el catálogo crezca y haya partners serios consumiendo el API, evaluaremos modelo de pricing premium (white-label, SLA). Por ahora, todo en abierto con atribución.

Schema de respuesta · v1

Contract estable. Cambios breaking irán a v2. Los campos pueden ser null si la bodega aún no ha rellenado ese dato.

{
  "api_version": "v1",
  "attribution": "Powered by SommelierLab — https://sommelierlab.com",
  "id": "V057-2024",
  "vino_id": "V057",
  "anyada": "2024",
  "name": "AUZELLS 2024",
  "do": "Costers del Segre",
  "graduacion": 13.5,
  "winery": {
    "name": "Celler Tomàs Cusiné",
    "logo_url": "https://...",
    "description": "...",
    "enoturismo": true,
    "enoturismo_url": "https://...",
    "social": { "instagram": "...", "facebook": "...", "website": "..." }
  },
  "narrative": {
    "es": "Bajo el cielo despejado de Les Garrigues...",
    "ca": "Sota el cel ras de les Garrigues...",
    "en": "Beneath the clear skies..."
  },
  "available_langs": ["es", "ca", "en", "fr", "de", "it"],
  "tasting_notes": { "color": "...", "aroma": "...", "boca": "..." },
  "audio_url": "https://cdn.../audio.mp3",
  "audio_per_lang": { "es": "...", "en": "..." },
  "elaboration": { "vinificacion": "...", "crianza": "..." },
  "certificates": ["ecológico", "vegano"],
  "awards": [
    { "name": "Decanter Asia 2024", "year": 2024, "image_url": "..." }
  ],
  "sommelier": {
    "agent_id": "elevenlabs/agent_xxx",
    "enabled": true
  },
  "buy_url": "https://www.tomascusine.com/producto/auzells-75cl/",
  "buy_url_markets": { "ES": "...", "FR": "...", "DE": "..." },
  "embed_url": "https://qr2.sommelierlab.com/?vino_id=V057&anyada=2024",
  "qr1_legal_url": "https://qr2.sommelierlab.com/legal/V057-2024",
  "thumbnail": "https://cdn.../bottle.png",
  "theme": { "primary": "#8E2F4F", "accent": "#d4af37" },
  "published_at": "2026-05-13T14:32:00Z"
}

🔍 Search API

Descubre vinos del catálogo · sin saber el código exacto

Búsqueda en el catálogo SommelierLab por nombre, denominación de origen, bodega o tipo. Útil para distribuidores con catálogo (Vinissimus, Drinks&Co…), restaurantes con carta digital, apps de cata o ChatGPT-style agents que quieren resolver "Roureda 2024" a un vino concreto antes de pedir su ficha completa.

GET /api/public/v1/search

?q=Roureda                  → fuzzy en nombre
?do=Costers del Segre       → filtro por DO
?bodega=B013                → bodega_id o nombre
?tipo=tinto                 → tinto/blanco/rosado/espumoso/...
?limit=20                   → default 20, máx 50
?ean=841…                   → roadmap (501 not_implemented hoy)

Ejemplo de respuesta:

{
  "api_version": "v1",
  "attribution": "Powered by SommelierLab — https://sommelierlab.com",
  "query": { "q": "Roureda", "do": null, "bodega": null, "tipo": null, "limit": 20 },
  "total": 2,
  "results": [
    {
      "id": "V057-2024",
      "vino_id": "V057",
      "anyada": "2024",
      "name": "Roureda Sumoll 2024",
      "tipo": "tinto",
      "do": "Costers del Segre",
      "winery": { "bodega_id": "B013", "name": "Celler Tomàs Cusiné" },
      "thumbnail": "https://cdn.../bottle.png",
      "wine_url": "/api/public/v1/wines/V057/2024",
      "embed_url": "https://qr2.sommelierlab.com/?vino_id=V057&anyada=2024"
    }
  ]
}

Solo devuelve vinos PUBLICADOS. Cache 5 min. CORS abierto. Sin API key. Tras encontrar el vino, llama a /api/public/v1/wines/{vino_id}/{anyada} para la ficha completa.

🤖 IA y buscadores

La Identidad Digital del Vino está optimizada para ser citada por ChatGPT, Perplexity, Google y Claude

Cuando un consumidor pregunta a una IA sobre un vino concreto, la IA responde con lo que encuentra indexado. Si ese vino está en SommelierLab, los datos canónicos (autenticados por la bodega) son los preferidos sobre opiniones anónimas de Vivino o fichas planas de distribuidores.

🔍 Datos estructurados

· JSON-LD Schema.org Product/Wine en cada ficha
· Open Graph + Twitter Cards ricas
· Bodega como `brand` + `publisher` declarados
· Indexable por Google Knowledge Graph

🤖 Friendly para IAs

· llms.txt con permisos explícitos a GPTBot, ClaudeBot, PerplexityBot
· Endpoint markdown /api/public/v1/wines/X/Y/md
· sitemap.xml dinámico con todas las fichas
· Citación obligatoria con link a la bodega

/sitemap.xml

Catálogo completo indexable

/llms.txt

Política para agentes IA

.md endpoint

Ejemplo · ficha markdown

¿Por qué SommelierLab y no otra ficha?

Auténtico

Cada vino lo aprueba su bodega. No es ficha del distribuidor. Cuando integras nuestra API muestras la voz REAL del productor.

Único

Una sola identidad por vino × añada en el mundo. Sin duplicados, sin fichas paralelas, sin inconsistencias.

Portátil

Mismo dato, mismo schema, en cualquier sitio donde aparezca el vino. Tu integración no se rompe cuando cambian las bodegas.

¿Listo para integrar?

El tier free no requiere registro. Si necesitas Pro o Enterprise, escríbenos.

hola@sommelierlab.com

SommelierLab · Identidad Digital del Vino · API v1 · 2026