API de productos

Un lookup por código de barras que devuelve el producto, la marca y la foto

API REST para EAN, UPC e ISBN. Cubre almacén, libros, juegos, música, cosmética, farmacia, papelería, mascotas y ferretería. Si el código no está en la base, lo buscamos en 87 fuentes y guardamos el resultado.

Sin tarjeta · Respuesta desde caché en milisegundos · Precios en pesos

GET /v1/products/barcode/:ean200 OK · 8ms

$ curl https://api.ez-catalog.huggian.com/v1/products/barcode/9789876129787 \
  -H "X-Api-Key: ezc_free_xxxxxxxx"

# respuesta: ISBN, clasificado como libro
{
  "name": "A Veces Se Gana, A Veces Se Aprende",
  "brand": "V&R",
  "barcode": "9789876129787",
  "product_type": "book",
  "image_url": "https://images.huggian.com/products/9789876129787.jpg",
  "attributes": {
    "author": "MAXWELL, JOHN C."
  }
}

Qué hace

Buscar

Por código o por texto. La app que consume no necesita saber de dónde salió el dato.

  • Lookup por barcode
  • Búsqueda en castellano
  • Lotes
  • Rápido de verdad

Clasificar

Cada producto viene con categoría, familia y marca normalizada.

  • 10 verticales
  • Categorías y familias
  • Marcas limpias
  • Tipo inferido

Completar

Lo que falta se busca afuera; lo que está mal se puede corregir.

  • Fan-out a 87 fuentes
  • Atributos por vertical
  • Imágenes servidas
  • Campos verificados

Aportar

La base crece con quien la usa.

  • Propuestas desde el plan Free
  • Escritura en Basic y Pro
  • Usado por ez-commerce

Para empezar

  1. 01Pedís la key

    Aparece en pantalla y llega por email.

  2. 02La mandás en X-Api-Key

    En cada request a /v1.

  3. 03Subís de plan cuando hace falta

    Desde el panel, sin cortes.

Planes

Precios por mes en pesos. Los límites de esta tabla son los que aplica la API.

  • Free

    Para probar y prototipar.

    Gratis Gratis

    • 50 requests por mes, 10 por minuto
    • Lookup por barcode, marca y categoría
    • Propuestas de corrección
  • Basic

    Para apps en producción.

    $14.999 $14.999 /mes

    • 25.000 requests por mes, 60 por minuto
    • Búsqueda full-text
    • Escritura de productos e imágenes
  • Pro

    Para plataformas con tráfico.

    $44.999 $44.999 /mes

    • 200.000 requests por mes, 300 por minuto
    • Todo lo de Basic, incluido borrado
    • Soporte prioritario

¿Necesitás más volumen o un acuerdo a medida? Escribinos por WhatsApp.

Preguntas frecuentes

¿Qué es una API de código de barras de productos?

Es un servicio al que le mandás el código de barras (EAN, UPC o ISBN) de un producto y te devuelve su nombre, marca, categoría y foto, sin que vos tengas que cargar esos datos a mano. ez-catalog es esa API para el mercado argentino: consultás un código y, si no lo tenemos en caché, lo buscamos en 87 fuentes y lo guardamos para la próxima.

¿Cómo consulto un producto por código de barras?

Con un GET a /v1/products/barcode/:codigo y tu API key en el header. La respuesta trae nombre, marca, categoría y foto en JSON. No hace falta armar tu propia base de productos para empezar: la primera consulta ya devuelve el dato si está en alguna de las 87 fuentes.

¿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 argentinos empiezan con 779; libros con 978/979; el resto se resuelve por fan-out.

¿Qué pasa si el producto no está en la base?

Consultamos 87 fuentes en paralelo: bases abiertas globales y catálogos públicos de retailers de AR, CL, MX y otros mercados, por vertical. Si alguna responde, guardamos el resultado y te lo devolvemos. Si nadie responde, 404.

¿Cómo funciona el rate limit?

Ventana deslizante de 60 segundos por API key. Si te pasás recibís un 429 con el header Retry-After. La cuota mensual se cuenta aparte y se reinicia cada mes.

¿Puedo usar Free en producción?

Free es para probar: 50 lookups por mes y solo por código. Para producción necesitás Basic o Pro. No hay fecha de corte ni migración brusca cuando subís.

¿Cómo pago?

Desde el panel de Huggian con Mercado Pago. Factura disponible en todos los planes pagos.

Probalo con un curl

La key gratis alcanza para probar la API contra tus propios códigos.