Introducción

ConsumerStore le ofrece una API que le permite acceder a la información de precios de nuestro catálogo, gracias a nuestra API tendrá acceso a información sobre el precio de millones de productos en todas las tiendas que analizamos.

Para acceder a la API debe estar registrado cómo usuario y registrar un API Key en su cuenta. Los pasos a realizar serían

1.- Regístrese cómo usuario de ConsumerStore utilizando el formulario de registro o a través de su cuenta de Google
2.- Acceda a su cuenta al apartado API y genere una nueva APIKEY
3.- Realice la integración de la API Key

Tenga en cuenta que hay información que está restringida por determinados acuerdos comerciales, por lo que hay tiendas de las que no se proporciona información.

Limitaciones de la API

La API está limitada a 1000 peticiones al mes de forma gratuita, si necesita más peticiones póngase en contacto con nuestro equipo y le pasaremos un presupuesto a medida.

Métodos

Obtener el precio de un producto

Descripción

Obtiene la lista de precios de un producto determinado en las tiendas existentes

URL de la API

https://www.consumerstore.com/api/

Petición

Realice una petición GET o POST a la URL de la API, con los siguientes parámetros:

  • apikey, incluya aquí su API Key
  • method=product.getprice
  • market, Mercado de acceso (uk, de, fr, it, es)
  • ean, EAN del producto a consultar (13 dígitos)

Resultado

  • status, Valores posibles: OK, FAIL
  • error, Código de error en caso de que la petición falle
  • result, listado de precios:
    • platform, Nombre de la tienda
    • platform_url, URL de la tienda
    • product, Nombre del producto en la tienda
    • product_url, URL del producto en la tienda
    • price, Último precio encontrado
    • unix_timestamp, Fecha en la que se encontró el precio

Errores posibles

  • INCORRECT_METHOD, El método indicado no existe.
  • INCORRECT_EAN, EAN incorrecto o de un producto no existente en nuestro catálogo.
  • INCORRECT_MARKET, El mercado que ha incluido no existe.
  • INCORRECT_IP, La IP de acceso no está permitida.
  • INCORRECT_APIKEY, La API KEY indicada no existe.
  • LIMIT_REACHED, Ha alcanzado el limite de peticiones permitidas.

Ejemplo de petición GET

https://www.consumerstore.com/api/?apikey={APIKEY}&method=product.getprice&market={MARKET}&ean={EAN}