mercado libre

Realizar búsquedas con filtros con la API de MercadoLibre

Los filtros en la búsqueda nos permiten obtener resultados mas adecuados a nuestro interés, podemos filtrar por vendedor, estado, rangos de precios, ubicación y mas criterios, obviamente son muy útiles al momento de buscar un producto. También existen filtros propios de algunos productos, como capacidad, modelo, etc. En éste post nos centraremos en algunos de los filtros estándar de todas las búsquedas.

Recuerden que MLA corresponde a MercadoLibre Argentina, dependiendo del pais donde deseen realizar la búsqueda cambia el código.

Filtrar por estado del producto

Para obtener productos nuevos, usados o todos debemos añadir el parámetro condition a la URL

Para buscar productos nuevos le damos el valor new, para productos usados used y para todos los productos all.

https://api.mercadolibre.com/sites/MLA/search?condition=new&q=dell

Si no reconoce el valor que se pasa al parámetro condition busca todos los articulos.

Filtrar por ubicacion del producto

Para obtener productos de diferentes provincias hay que usar el parámetro state con el valor que corresponde con el país y provincia (estado), los códigos de los países son los que corresponden a las normas ISO y para las provincias (estados) hay que chequearlos.

Por ejemplo, para buscar en Argentina en Capital Federal hay que realizar la siguiente llamada.

https://api.mercadolibre.com/sites/MLA/search?state=ar-c&q=asus

Para ver la lista de provincias (estados) de una pais debemos realizar la siguiente llamada.

https://api.mercadolibre.com/countries/AR

Donde AR corresponde al código de Argentina, si quieren ver los códigos de los países pueden realizar la misma llamada pero sin el código del país como parámetro.

https://api.mercadolibre.com/countries

La ID de los países se corresponde con el código que deben ingresar para ver las provincias (estados).

 Filtrado por tipo de venta

El filtrado por tipo de venta nos permite elegir entre subastas y ventas “directas”, el parámetro que se utiliza para filtrar es buying_mode (tipo de venta), y los valores permitidos son “auction” o “buy_it_now“, el primero corresponde a subastas y el segundo a ventas directas.

https://api.mercadolibre.com/sites/MLA/search?q=pc&buying_mode=buy_it_now

Filtrado por precio del articulo

El filtrado por precio nos permite elegir entre rangos de precio para el articulo que buscamos, el parámetro es price y los valores se pasan así: precio_inferior – precio_superior.

Ejemplo: Buscar productos hasta $100, para eso debemos darle el siguiente valor al parámetro price, “*-100”, sin las comillas.

Buscar productos entre $50 y $200, para eso debemos darle el siguiente valor al parámetro, “50-200”.

Buscar productos de mas de $500, para eso le damos el valor “500-*”.

https://api.mercadolibre.com/sites/MLA/search?q=ipad&price=*-500

En ése caso estamos buscando un ipad con un precio inferior a $500, o sea estamos soñando, pero bueno, soñar es gratis.

En la proxima entrega seguiremos un poco mas con el tema de los filtros, ya que queda aún un poco por aprender.

Si desean aprender mas pueden realizar una busqueda y buscar en la propiedad “available_filters” del objeto JSON que obtenemos como resultado.

Primeros pasos con la API de MercadoLibre

Hace bastante MELI introdujo una nueva API REST que devuelve los resultados en JSON, lo que la hace bastante mejor que la anterior que funcionaba con XML, al menos para mi gusto.

Ahora vamos a ver algunas llamadas básicas para comenzar a comprender como funciona y luego realizar una pequeña tienda utilizando CodeIgniter (PHP).

La API cuenta con llamadas publicas y privadas, para las primeras no necesitamos estar logueados en MELI (no se necesita cuenta), en el caso de las privadas si necesitamos estar logueado, ya que las llamadas permiten acceder a datos del usuario.

En algunas de las llamadas se debe añadir como parámetro el sitio de MercadoLibre del que se quieren obtener los resultados, pueden ver un listado en la siguiente dirección.

https://api.mercadolibre.com/sites/

Llamadas publicas

Una de las llamadas publicas permite realizar búsquedas, la URL a la que se debe realizar es la siguiente, observen que el tercer segmento de la URL incluye el sitio de MercadoLibre del que se quieren obtener los resultados, MLA corresponde a MercadoLibre Argentina.

https://api.mercadolibre.com/sites/MLA/search?q=NOMBRE DEL PRODUCTO

El nombre del producto, la query, no permite espacios (en PHP), por lo tanto si se trata de un producto compuesto por varias palabras se deben reemplazar los espacios por signos más (+), aunque si la llamada la hacemos directamente desde el navegador este se encarga automáticamente de hacerlo, por lo tanto la URL quedaría así.

https://api.mercadolibre.com/sites/MLA/search?q=NOMBRE+DEL+PRODUCTO

Si prueban de ingresar la URL en el navegador verán que pueden ver lo que devuelve la API, aunque de manera “reducida”, para ver la respuesta completa deben hacer clic en el botón que dice “expand all”.

Además, los resultado en la parte derecha muestra información sobre el resultado de la llamada realizada, la “API description” es una descripción breve del contenido que devuelve la API, uno de los mas importantes es el campo “Attributes” que nos describe cada uno de los atributos del objeto JSON devuelto. En “Allowed methods” podemos encontrarnos con distintas opciones para realizar llamadas a la misma API para obtener resultados mas específicos, mediante el agregado de parámetros. En “Related resources” nos encontramos con llamadas que están relacionadas con la cual realizamos.

En los próximos posts hablaremos sobre el tema de aplicación de filtros para las búsquedas y otras llamadas, mientras tanto pueden acceder a mercadolibre.io para investigar por su cuenta.

Otros posts sobre la API de MELI.

Filtrar búsquedas en la API de MercadoLibre

Nueva API de MercadoLibre

Hace mucho tiempo que se pedía que MercadoLibre desarrolle una API para realizar consultas a la pagina de manera mas sencilla, a que hasta hace un tiempo solo teníamos XML y dolor de cabeza, ahora por suerte la gente de MELI está avanzando con la nueva API que funciona con JSON  y que, a mi parecer, hace las cosas mas sencillas.

Pueden ver ejemplos de código en ar.mercadolibre.io, además hay un poco de documentación, yo por mi parte del dejo un ejemplo que comente para que vean, lo comente como para entender bien como funcionaba todo, si tienen dudas pueden consultarme no tengo problemas, perdón por el lenguaje pero en principio lo había comentado para mi entendimiento y el de un amigo simplemente.

Pequeña advertencia sobre MercadoSocios

Hace un tiempo comencé a usar MercadoSocios – que es el sistema de referidos de MercadoLibre – y la verdad no me funcionaba para nada bien, la cuestión es que me daba resultados bastante malos en los 3 meses que lo había estado probando, hace unos días descubrí la razón principal para ésto y se debía a un simple problema de geolocacion e ignorancia mía.

Cuando entraba para ver mis estadísticas de registros a través de mis links veía que había muchísimos usuarios que se creaban cuentas, las confirmaban, pero nunca compraban nada, entonces fue cuando me di cuenta que en realidad había algo mal con los links y preguntando al soporte me dijeron que cuando creamos links debemos tener en cuenta el país en el cual se va a crear la cuenta el usuario o a realizar la compra.

Como crear correctamente links para Mercado Socios

Por ejemplo: Para crear un link para que se registren usuarios de Argentina debemos seleccionar de la lista de países a Argentina y en la URL a insertar el link debe estar dirigido a MercadoLibre Argentina, ya sea al formulario de registro o a un articulo o categoría, pero siempre de Argentina.

Crear link de referidos en Mercadosocios

En caso de que sea dirigido a usuarios de otros país debemos seleccionarlo y recordar que el link debe apuntar al sitio de Mercado Libre del mismo.

Quienes estén familiarizados con Internet y Mercado Libre sabrán muy bien que con la ayuda de Google uno puede encontrar los locales de los vendedores del portal sin necesidad de hacer una oferta con solo introducir un nombre en el buscador, desde luego al hacer ésto la gente de Mercado Libre pierde su comisión por la venta, veamos un ejemplo para que todos entiendan a lo que me refiero.

Entramos a Mercado Libre y encontramos un articulo que nos interesa, al verlo vemos que el banner que nos muestra el vendedor tiene el nombre del mismo.

Producto en Mercado Libre

Realizamos una busqueda en Google para ver si logramos encontrar al vendedor.

Resultado de la búsqueda

En este caso fue posible encontrar al vendedor, por lo que lo podemos contactar directamente.

Mercado Libre es útil igualmente

Buscar productos en Mercado Libre sigue siendo útil porque podemos comparar precios, ver las calificaciones del vendedor y las opiniones de los compradores, ademas podemos comprar a través de Mercado Pago para estar protegidos en caso de que no podamos ir al local de venta del producto y debamos realizar la compra a través de la web o telefónicamente.

Una aclaración es que para aquellos vendedores que recién estén comenzando puede preferir que realicemos las compras a través del portal para aumentar sus calificaciones.