⚡ API REST v1

API para Desarrolladores

Integra el catálogo de miles de productos de México en tu app, punto de venta o sistema. Consultas por código de barras, búsqueda por nombre e información nutricional.

Inicio rápido

Base URL: https://preciocheck.com/api/v1

Autenticación: API Key en header X-API-Key: tu_api_key

Formato: Todas las respuestas son JSON.

Ejemplo — buscar un producto por código de barras:

# Buscar producto por código de barras
curl -H "X-API-Key: tu_api_key" \
  https://preciocheck.com/api/v1/producto/7501055303038

Endpoints

GET /api/v1/producto/:codigo_barras

Obtiene la información completa de un producto por su código de barras (EAN-13, UPC-A, etc.).

Parámetros URL: codigo_barras — Código EAN/UPC (8-14 dígitos)

Respuesta exitosa (200):

{
  "ok": true,
  "producto": {
    "codigo_barras": "7501055303038",
    "nombre": "Coca-Cola 600ml",
    "marca": "Coca-Cola",
    "categoria": "Bebidas",
    "precio_sugerido": 18.50,
    "imagen_url": "https://...",
    "descripcion": "Refresco de cola 600ml",
    "contenido_neto": "600 ml",
    "pais_origen": "México"
  }
}
GET /api/v1/buscar?q=nombre&cat=categoria

Busca productos por nombre, marca o categoría.

Query params:

  • q — Texto de búsqueda (mín. 2 caracteres)
  • cat — (Opcional) Filtrar por categoría exacta
  • limite — (Opcional) Máximo resultados, por defecto 20, máximo 50
  • offset — (Opcional) Para paginación

Respuesta exitosa (200):

{
  "ok": true,
  "total": 15,
  "productos": [
    { "codigo_barras": "...", "nombre": "...", ... }
  ]
}
GET /api/v1/categorias

Lista todas las categorías disponibles con el conteo de productos.

Respuesta (200):

{
  "ok": true,
  "categorias": [
    { "nombre": "Bebidas", "total": 842 },
    { "nombre": "Abarrotes", "total": 753 },
    ...
  ]
}
GET /api/v1/precios/:codigo_barras

Obtiene los precios reportados por tiendas y comunidad para un producto.

Respuesta (200):

{
  "ok": true,
  "codigo_barras": "7501055303038",
  "precios": [
    {
      "tienda": "Abarrotes Don Pepe",
      "precio": 19.00,
      "precio_oferta": null,
      "verificado": true,
      "fecha": "2026-02-18"
    }
  ]
}
POST /api/v1/reporte-precio

Reporta el precio de un producto en una tienda. Solo para planes Pro y Enterprise.

Body (JSON):

{
  "codigo_barras": "7501055303038",
  "nombre_tienda": "Mi Tiendita",
  "precio": 19.50,
  "precio_oferta": 17.00,
  "ciudad": "Guadalajara",
  "estado_mx": "Jalisco"
}

Códigos de error

Código Significado
200Éxito
400Parámetros inválidos o faltantes
401API Key inválida o faltante
404Producto no encontrado
429Demasiadas solicitudes (rate limit)
500Error interno del servidor

Límites de uso

Plan Consultas/día Rate limit Reportar precios
Gratis10010/minNo
Básico1,00030/minNo
Pro10,00060/minSí
EnterpriseIlimitadas120/minSí

Ejemplos de integración

JavaScript / Node.js

// Buscar producto por código de barras
const resp = await fetch('https://preciocheck.com/api/v1/producto/7501055303038', {
  headers: { 'X-API-Key': 'tu_api_key' }
});
const data = await resp.json();
console.log(data.producto.nombre); // "Coca-Cola 600ml"

Python

import requests

resp = requests.get(
  'https://preciocheck.com/api/v1/buscar',
  params={'q': 'coca cola', 'limite': 5},
  headers={'X-API-Key': 'tu_api_key'}
)
for prod in resp.json()['productos']:
  print(prod['nombre'], prod['precio_sugerido'])

cURL

# Buscar por texto
curl -H "X-API-Key: tu_api_key" \
  "https://preciocheck.com/api/v1/buscar?q=leche&cat=Lácteos&limite=10"

# Listar categorías
curl -H "X-API-Key: tu_api_key" \
  https://preciocheck.com/api/v1/categorias

¿Listo para integrar?

Obtén tu API Key en minutos. El plan gratuito incluye 100 consultas diarias, perfecto para desarrollo y pruebas.

Solicitar API Key Ver planes