Busca items por vendedor

Utilizando nuestro recurso público /sites/{site_id}/search? podrás obtener los resultados de ítems activos directamente de los listados de Mercado Libre.

Utilizando nuestro recurso privado /users/{cust_id}/items/search?access_token= podrás obtener un listado de los ítems publicados por determinado user desde su cuenta.

Contenidos:

Obtiene ítems de los listados por vendedor

Esta búsqueda se ajusta a las reglas de los listados del site. Los resultados siempre serán de ítems activos.
Notas:

  • Obtiene directamente la URL del listado de Mercado Libre, reemplazando /search? por /searchUrl?
  • Están limitadas las búsquedas con offset por encima de 50.000.

Por nickname

Cuando no conoces el seller_id de un usuario pero sí el apodo, puedes intentar realizar la siguiente búsqueda:

curl https://api.mercadolibre.com/sites/MLA/search?nickname=

Por seller_id

Si ya conoces el seller_id, solo haz lo siguiente:

curl https://api.mercadolibre.com/sites/MLA/search?seller_id=

Nota: Si bien con la API sites/(site_id) podrás ver la descripción de los ítems esta no devuelve la totalidad de los anuncios de un seller.
Si deseas ver el listado completo sin la descripción deberás hacer la siguiente llamada:

https://api.mercadolibre.com/users/{seller_id}/items/search?access_token=$ACCESS_TOKEN

Por seller_id para una categoría específica

Recuerda que las búsquedas anteriores no recuperan las publicaciones clasificadas del vendedor, solo sus productos. Puedes utilizar el siguiente ejemplo para buscar dentro de una categoría específica. Esta llamada acepta categorías clasificadas para consultar también esas publicaciones.

curl https://api.mercadolibre.com/sites/MLB/search?seller_id=36060987&category=MLB1743

Ahora que conoces el ID de cada artículo de un vendedor, puedes realizar una llamada al recurso de los artículos para conocer más sobre ellos.
Para mejorar la llamada que estás realizando, te recomendamos utilizar multiget y las prestaciones de selección para poder acceder a un máximo de 50 productos con una sola llamada y solamente en los campos que te interesan.

Llamada:

https://api.mercadolibre.com/items?ids={Item_id1},{Item_id2}&attributes={attribute1,attribute2,attribute3}

Ejemplo:

https://api.mercadolibre.com/items?ids=MLA599260060,MLA594239600&attributes=id,title,seller_id,price,available_quantity,status

Respuesta:

{
	"available_quantity": 24,
	"id": "MLA594239600",
	"price": 1999,
	"seller_id": 143125485,
	"status": "active",
	"title": "Celular Libre Samsung Galaxy Ace 4 Neo Blanco"
  },
  {
	"available_quantity": 5,
	"id": "MLA599260060",
	"price": 7999,
	"seller_id": 167520920,
	"status": "active",
	"title": "Aire Acondicionado Split Rca Frio Calor 3400w"
  }

Filtra y Ordena los resultados de búsqueda en los listados

Dentro de /sites/{site_id}/search? están los campos “available_sorts” y “available_filters”.

¿Cómo filtrar?
Por ejemplo, para filtrar ítems con envío gratis encontrarás entre los ”available_filters” disponibles el ID “shipping” y dentro de éste el value con ID “free”.

https://api.mercadolibre.com/sites/MLA/search?seller_id={cust_id}&shipping=free


¿Cómo ordenar?
En este caso deberás agregar “sort” con el ID disponible del orden que quieras aplicar, por ejemplo: “price_asc”

https://api.mercadolibre.com/sites/MLA/search?seller_id={cust_id}&sort=price_asc

Nota: Por defecto la búsqueda en los listados ya viene con un orden de relevancia definido.

Obtiene items de la cuenta de un vendedor

Esta búsqueda se realiza directamente sobre la cuenta del vendedor, por lo que el recurso es privado y se necesita un access_token.

Nota: Ten en cuenta que utilizando esta llamada, obtendrás un listado de ítems. Para obtener más información sobre cada uno, sugerimos utilizar un multiget tal como explicamos anteriormente.

Por seller_id

Si ya conoces el seller_id, solo haz lo siguiente:

curl https://api.mercadolibre.com/users/{seller_id}/items/search?access_token=$ACCESS_TOKEN

Por SKU

Si el item tiene cargado un SKU en el campo “seller_custom_field” puedes buscarlo del siguiente modo:

curl https://api.mercadolibre.com/users/{Cust_id}/items/search?sku={seller_custom_field}&access_token=$ACCESS_TOKEN

Por estado

curl https://api.mercadolibre.com/users/{Cust_id}/items/search?status=active&access_token=$ACCESS_TOKEN

Filtra y Ordena los resultados de los ítems del vendedor

Dentro de /users/{cust_id}/items/search? están los campos “available_orders” y “available_filters”

¿Cómo ordenar?
En este caso deberás agregar “orders” con el ID disponible del orden que quieras aplicar, por ejemplo: “start_time_desc”

https://api.mercadolibre.com/users/226384143/items/search?orders=start_time_desc&access_token=$ACCESS_TOKEN

Nota: Por defecto ya viene con un orden stop_time_asc aplicado.

¿Cómo filtrar?
Por ejemplo, para filtrar ítems con listing_type “gold_pro” encontrarás entre los ”available_filters” disponibles el ID “listing_type_id” y dentro de éste el value con ID “gold_pro”.

https://api.mercadolibre.com/users/{Cust_id}/items/search?isting_type_id=gold_pro&access_token=$ACCESS_TOKEN

Para más ejemplos de búsquedas, consulta: Ítems y búsquedas.

Por favor califica del 1 al 5