50+ fuentes · 10 verticales · AR + global
Un solo lookup
para todo lo que
tiene barcode.
API REST que busca por EAN/UPC/ISBN en almacén, libros, juegos, música, cosmética, farmacia, papelería, mascotas y ferretería. Fan-out a 50+ proveedores, merge por confianza.
$ curl https://api.ez-catalog.huggian.com/v1/products/barcode/9789876129787 \
-H "X-Api-Key: ezc_free_xxxxxxxx"
# respuesta — ISBN → libro auto-clasificado
{
"name": "A Veces Se Gana, A Veces Se Aprende",
"brand": "V&R",
"barcode": "9789876129787",
"product_type": "book",
"image_url": "https://imagenesal.bros.me/...",
"attributes": {
"author": "MAXWELL, JOHN C.",
"price_ars": 25300
}
}Libros, juegos, música, cosmética, farmacia, mascotas, papelería, ferretería, almacén. Un solo endpoint.
Diseñado para velocidad y precisión
Cada endpoint pensado para el mercado argentino. Datos reales, respuestas rápidas, integración simple.
Velocidad
Caché Redis integrado
Las búsquedas por código de barras se resuelven desde memoria. Latencia p99 menor a 10ms para productos cacheados.
Búsqueda
Full-text en español
Motor de texto completo con stemming en español. Busca "coca cola" y encuentra "Coca-Cola 500ml", "Coca-Cola Zero" y variantes.
Multi-vertical
10 verticales soportadas
Almacén, libros, juegos de mesa, TCG, papelería, cosmética, farmacia, música, mascotas y ferretería. product_type derivado automático del barcode + proveedor.
Fan-out
50+ fuentes en paralelo
Bases de datos abiertas globales (alimentos, cosmética, libros, música) + catálogos públicos de retailers de AR, CL, MX y mercados globales (UK, UE, Australia, etc.) por vertical: almacén, farmacia, mascotas, ferretería, papelería, librería, jugueterías, electrónica. Merge por confianza, attributes shallow-merge por peso.
Taxonomía
Categorías jerárquicas
Árbol de categorías con padre-hijo. Filtrá búsquedas por categoría para resultados más precisos.
Acceso
API keys por tier
Free, Basic, Pro y Admin. Cada nivel tiene su rate limit y permisos. Escalá a medida que crecés tu aplicación.
Integración en 3 pasos
Sin SDKs propietarios, sin configuración compleja. REST puro con JSON.
Creá tu API key
Registrate en Huggian y generá tu key gratuita en segundos. Sin tarjeta de crédito requerida para el plan Free.
curl https://api.ez-catalog.huggian.com/v1/products/barcode/7790895000997 \
-H "X-Api-Key: ezc_free_xxxxxxxx"Integrá en tu app
Una sola llamada HTTP. Funciona con cualquier lenguaje: Rust, Python, JavaScript, PHP, Go. Respuesta JSON limpia.
// JavaScript
const res = await fetch('/v1/products/search?q=leche', {
headers: { 'X-Api-Key': process.env.EZ_CATALOG_KEY }
});
const products = await res.json();Buscá y escalá
Empezá con el plan Free. Cuando necesitás más volumen o escritura, subí a Basic o Pro con un clic desde el panel.
// Contribuir un producto nuevo (Basic+)
POST /v1/products
{
"barcode": "7798xxx",
"name": "Mi producto",
"brand": "Mi marca"
}Precios en pesos
Pagás en ARS. Sin conversiones, sin sorpresas. Cancelás cuando quieras.
Free
Para probar la API y prototipos.
- ✓ 1.000 requests / mes
- ✓ 10 requests / minuto
- ✓ Solo lookup por código de barras
- ✓ 1 API key
- ✓ Sin tarjeta de crédito
Basic
Más popularPara apps en producción con volumen moderado.
- ✓ 100.000 requests / mes
- ✓ 60 requests / minuto
- ✓ Búsqueda full-text + categorías
- ✓ Lectura y escritura — contribuir productos
- ✓ Acceso a logos de marcas
- ✓ Soporte por email
Pro
Alto volumenPara plataformas con alto tráfico.
- ✓ 1.000.000 requests / mes
- ✓ 300 requests / minuto
- ✓ Webhooks de actualización
- ✓ SLA 99.9% garantizado
- ✓ Soporte prioritario
¿Necesitás Enterprise o mayor volumen? Contactanos.
Preguntas frecuentes
¿Algo más? Escribinos a hola@huggian.com
¿Qué tipos de barcode soporta? + −
EAN-13, UPC-12 (con padding automático a EAN-13) e ISBN-10 (normalizado a ISBN-13 con prefijo 978). Productos AR empiezan con 779; libros con 978/979; el resto va por fan-out a múltiples proveedores.
¿Qué verticales cubre? + −
Almacén/bebidas/golosinas (AR + global), libros (ISBN), juegos de mesa, TCG (Magic/Pokemon/Yu-Gi-Oh), papelería, cosmética, farmacia, música (CD/vinilo), mascotas (AR + CL) y ferretería/construcción (AR). El product_type se infiere del prefijo del barcode + la fuente que respondió.
¿Qué pasa si el producto no está en la base de datos? + −
Hacemos fan-out a 50+ fuentes externas en paralelo: bases de datos abiertas globales (alimentos, cosmética, libros, música, mascotas) y catálogos públicos de retailers de AR, CL, MX y mercados globales (UK, UE, Australia, etc.) por vertical. Si alguna responde, persistimos el hit automáticamente y devolvemos el resultado. Si nadie responde, 404.
¿Cómo funciona el rate limit? + −
Se cuenta por ventana deslizante de 60 segundos por API key. Si superás el límite recibís un 429 con el header Retry-After indicando cuántos segundos esperar.
¿Los datos están actualizados? + −
Cada lookup que cae en producto desconocido dispara un fan-out a fuentes externas y persiste el hit. Productos verificados manualmente llevan verified:true. Los attributes (autor, players, género musical, ingredientes) vienen del proveedor con mayor peso de cada campo.
¿Puedo usar la API en producción con el plan Free? + −
Free es para prototipos y pruebas — 1.000 lookups/mes y solo búsqueda por código de barras. Para producción real (búsqueda full-text, escritura, volumen) necesitás Basic o Pro. Sin fecha de vencimiento ni corte abrupto al migrar.
¿Cómo proceso el pago? + −
A través del panel de Huggian con MercadoPago o tarjeta de crédito. Factura disponible en todos los planes pagos.
Plan Free · sin tarjeta · sin fecha de vencimiento
1.000 requests / mes.
Gratis, hoy.
Cuando tu volumen crece, migrás a Basic o Pro con un clic desde el panel. Sin corte abrupto, sin sorpresa.
Un producto de Huggian · También: ez-stock · Hecho en Argentina