Datos Abiertos y API

Licencia

Los datos en Los Precios están disponibles como datos abiertos a través de una API gratis. Esto significa que los puedes usar para cualquier objetivo, de lucro o no, sin restricción. Esta licencia aplica únicamente para los datos provistos a través de esta API. No aplica para las imágenes provistas a través de esta ni para el resto del contenido del sitio Los Precios.

Definiciones

Un producto es una entidad abstracta que representa una necesidad de algún consumidor. Por ejemplo, el producto Leche Deslactosada representa la necesidad de un consumidor de leche que no le cause gases. Un ítem es el elemento que existe realmente en el mercado, tiene una marca, tamaño y presentación específica. Pueden existir diferentes ítems en el mercado que cumplan la necesidad de leche deslactosada, uno de ellos es Leche Larga Vida Descremada Deslactosada Alpina 1000 ml. Un ítem puede cumplir con múltiples necesidades de un consumidor e incluso combinaciones de estas. Por ejemplo, el ítem mencionado anteriormente también cumple con Leche Larga Vida, Leche Larga Vida Deslactosada, Leche Larga Vida Descremada, Leche Descremada y Leche Descremada Deslactosada.

Producto

Ruta:

losprecios.co/producto/detalles?ID=[123]&ClaveAPI=[ABC]&MunicipioID=[123]

ID: Número interno del producto en la base de datos. Es un número de 1 en adelante.

ClaveAPI: Clave para acceder a la API. Para obtenerla escríbeme a contándome el uso que le darás a los datos.

MunicipioID: Opcional: Número del municipio del que se devolverán los precios. Por el momento están habilitados: Bogotá = 1, Medellín = 2, Cali = 3 y Barranquilla = 4. Si no agregas este parámetro, se devuelven todos los precios disponibles. Cuando hay ciudades con precios diferentes, se da prioridad a los de Bogotá, después a los de Medellín, etc.

Ejemplo de Respuesta en JSON:
{"Resultado": "Ok","Datos":{
"Nombre": "Leche",
"Unidad": "ml",
"Descripción": "Leche de vaca. Alimento básico y equilibrado con excelente densidad nutricional. Aporta proteínas de alto valor biológico, calcio, fósforo, vitaminas A, D y del complejo B.",
"Complemento": "Cualquier tipo de leche líquida de vaca",
"NombrePorción": "Vaso",
"TamañoPorción": 240.000,
"TamañoPresentaciónTípica": 1000.000,
"NombrePresentaciónTípica": "Bolsa",
"RutaImagen": "https://vixark.b-cdn.net/lp-i-p-g/imagen-no-disponible.jpg",
"Ítems":
    [{"Producto": "Leche Pasteurizada Entera",
    "ProductoID": 846,
    "Marca": "Latti",
    "Tamaño": 1000.000,
    "Unidad": "ml",
    "Complemento": null,
    "RutaImagen": "https://vixark.b-cdn.net/lp-i-i-g/imagen-no-disponible.jpg",
    "CódigoEAN13": null,
    "ÍtemsTiendas": [{"Tienda":"D1", "TiendaID":1, "Precio":1650.0000, "Fecha":"2019-06-12" }]},
...
,"ErrorID": 0,
"Mensaje": null}

Ítem

Rutas:

losprecios.co/ítem/detalles?ClaveAPI=[ABC]&MunicipioID=[123]&ID=[123]

losprecios.co/ítem/detalles?ClaveAPI=[ABC]&MunicipioID=[123]&CódigoEAN13=[123]

Si se especifica tanto el parámetro ID como el CódigoEAN13, se da prelación al ID.

ID: Número interno del ítem en la base de datos. Es un número de 1 en adelante.

CódigoEAN13: Código de barras del ítem.

ClaveAPI: Ver Producto.

MunicipioID: Ver Producto.

Ejemplo de Respuesta en JSON:
{"Resultado": "Ok","Datos":{
{"Producto": "Azúcar Blanca",
"ProductoID": 1959,
"Marca": "Riopaila",
"Tamaño": 1000.000,
"Unidad": "g",
"Complemento": null,
"RutaImagen": "https://vixark.b-cdn.net/lp-i-i-g/azúcar-blanca-riopaila-1000g.jpg",
"CódigoEAN13": null,
"ÍtemsTiendas":[
    {"Tienda":"D1", "TiendaID":1, "Precio":2300.0000, "Fecha":"2019-06-12"},
    {"Tienda":"Justo \u0026 Bueno", "TiendaID":3, "Precio":2700.0000, "Fecha":"2019-06-12"},
    {"Tienda":"Ara", "TiendaID":2, "Precio":2750.0000, "Fecha":"2019-06-12"},
    {"Tienda":"Carulla", "TiendaID":9, "Precio":3360.0000, "Fecha":"2019-06-12"}
]}
,"ErrorID": 0,
"Mensaje": null}

Si has especificado un MunicipioID y obtienes el objeto ÍtemsTiendas vacío ( "ÍtemsTiendas":[] ), esto significa que ese ítem no está disponible para el municipio indicado.

Buscar

Ruta:

losprecios.co/buscar/resultado?ClaveAPI=[ABC]&Término=[ABC]&Tipo=[ABC]&MunicipioID=[123]&TiendaID=[123]

ClaveAPI: Ver Producto.

Término: Término de búsqueda.

Tipo: Opcional. Si se omite, se devolverán productos ó ítems priorizando devolver productos. Si se especifica un tipo, se buscará únicamente ese tipo. El tipo puede ser Ítem o Producto. Si se especifica un TiendaID, siempre se devuelven ítems.

MunicipioID: Ver Producto.

TiendaID: Opcional: Número interno de la tienda en la base de datos. Es un número de 1 en adelante. Este número se puede obtener de la dirección de la tienda, por ejemplo de https://losprecios.co/alkosto_t11 se obtiene que 11 es el ID de Alkosto.

Ejemplo de Respuesta en JSON: {"Resultado": "Ok","Datos":{
"TipoResultado":4,
    "Productos":[{
        "Nombre": "Atún en Lata",
        "Unidad": "g",
        "Descripción": null,
        "Complemento": "Incluye rallado, lomitos y esparcible",
        "Nombre Porción": "Porción",
        "Tamaño Porción": 80.000,
        "Tamaño Presentación Típica": 170.000,
        "Nombre Presentación Típica": "Lata",
        "Ruta Imagen": "https://vixark.b-cdn.net/lp-i-p-g/imagen-no-disponible.jpg",
        "Ítems": []}
    ...
},
"ErrorID": 0,
"Mensaje": null}

Tienda

Rutas:

losprecios.co/tienda/detalles?ID=[123]&MunicipioID=[123]&ClaveAPI=[ABC]&Categoría=[ABC]&Subcategoría=[ABC]&Página=[123]

losprecios.co/tienda/lista?ClaveAPI=[ABC]&MunicipioID=[123]

ID: Ver TiendaID en Buscar.

Categoría: Opcional: Nombre de la categoría por la que se filtrarán los ítems de la tienda.

Subcategoría: Opcional: Nombre de la subcategoría por la que se filtrarán los ítems de la tienda.

Página: Opcional: Número de página de resultados. Si se omite, se devuelve la primera.

ClaveAPI: Ver Producto.

MunicipioID: /detalles: Ver Producto. /lista: Se devuelven las tiendas disponibles en el municipio especificado. Si se omite, se devuelven todas las tiendas.

Ejemplo de Respuesta en JSON:
{"Resultado": "Ok","Datos":{
{"Producto": "Azúcar Blanca",
"Nombre": "D1",
"ID":1,
"Email":null
"FormularioContacto":"http://www.d1.com.co/#contactenos"
"Teléfono":"(4) 448 91 40"
"Web":"http://www.tiendasd1.com"
"RutaImagen":"https://vixark.b-cdn.net/lp-i-t-g/d1.jpg"
"Ítems":[
...
]}
,"ErrorID": 0,
"Mensaje": null}

ID de Errores

0 = Solicitud sin errores.
1 = Clave de API incorrecta.
2 = Error del servidor.
3 = Solicitud muy frecuente.
4 = Producto no existente.
5 = Ítem no existente.
6 = No encontrado el código EAN13.
7 = No proporcionado ID ni código EAN13.
8 = Tipo incorrecto.
9 = Tienda no existente.
10 = Categoría no existente.
11 = Subcategoría no existente.
12 = Clave de API Desactivada.

Limitaciones

• Máximo una solicitud por segundo. Si necesitas realizar solicitudes más frecuentes, escríbeme con tu caso a .
• No descargues las imágenes en cada consulta, guárdalas en tu propio servidor. Las rutas de las imágenes se proveen por completitud, pero estrictamente no hacen parte de la API entonces el servidor te podría bloquear tu IP si realizas un consumo excesivo de estas.