Busca de produtos por vendedor

Utilizando o nosso recurso público /sites/{site_id}/search? você pode obter os resultados de itens ativos diretamente das listas do Mercado Livre.

Utilizando o nosso recurso privado /users/{cust_id}/items/search?access_token= você pode obter uma lista dos itens postados por determinado user a partir de sua conta.

Conteúdos:

Obtenha itens das Listas por Vendedor

Esta pesquisa atende às regras das listas do site. Os resultados sempre serão itens ativos.
Notas:

  • Obtenha diretamente a URL da lista do Mercado Livre, substituindo /search? por /searchUrl?
  • As pesquisas com offset acima de 50.000 são limitadas.

Por apelido

Se você não conhece o seller_id de um usuário, mas sabe o apelido dele, pode tentar fazer a seguinte busca:

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

Por seller_id

Se você já conhece o seller_id, faça o seguinte:

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

Nota: Embora com a API sites/(site_id) você possa visualizar a descrição dos itens, esta não retorna a totalidade dos anúncios de um seller.

Se você quiser ver a lista completa sem a descrição, deverá fazer chamada:

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

Por seller_id de vendedor em uma categoria específica

Lembre-se de que as buscas anteriores não recuperarão as publicações classificadas do vendedor, só seus produtos. Você pode usar o exemplo a seguir para buscar dentro de uma categoria determinada. Essa chamada aceita categorias classificadas para também consultar tais publicações.

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

Agora que você já conhece o ID de cada produto de um vendedor, poderá fazer uma chamada ao recurso dos produtos para saber mais sobre eles.
Para melhorar a chamada que está fazendo, recomendamos utilizar multiget e os recursos de seleção para acessar até 50 produtos com uma só chamada e somente nos campos de seu interesse.

Chamada:

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

Exemplo:

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

Resposta:

{
	"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"
  }

Filtre o Organize os resultados de pesquisa nas listas

Dentro de /sites/{site_id}/search? estão os campos “available_sorts” e “available_filters”.

Como filtrar?
Por exemplo, para filtrar itens com frete grátis, você encontrará entre os “available_filters” disponíveis o ID “shipping” e dentro dele o value com ID “free”.

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


Como realizar uma ordem?
Neste caso, você deve adicionar “sort” com o ID disponível da ordem que quiser aplicar, por exemplo: “price_asc”

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

Nota: Por default, a pesquisa nas listas se apresenta com uma ordem de relevância predeterminada.

Obtenha itens da conta de um vendedor

Esta pesquisa é diretamente realizada na conta do vendedor, portanto, o recurso é privado e não requer access_token.

Nota: Lembre que, utilizando esta chamada, você vai obter uma lista de itens. Para obter mais informações sobre cada um deles, sugerimos utilizar um multiget, como foi anteriormente explicado.

Por seller_id

Se você já conhecer o seller_id, só deve fazer o seguinte:

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

Por SKU

Se o item contém um SKU no campo “seller_custom_field”, você pode pesquisar da seguinte forma:

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

Por status

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

Filtre o Organize os resultados dos itens do vendedor

Dentro de /users/{cust_id}/items/search? estão os campos “available_orders” e “available_filters”

Como realizar uma ordem?
Neste caso, você deve adicionar “orders” com o ID disponível da ordem que quiser aplicar, por exemplo: “start_time_desc”

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

Nota: Por default, uma ordem orden stop_time_asc já vem aplicada.

Como filtrar?
Por exemplo, para filtrar itens com listing_type “gold_pro”, você encontrará entre os ”available_filters” disponíveis o ID “listing_type_id” e dentro dele o value com ID “gold_pro”.

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


Mais exemplos de pesquisas em: Itens e pesquisas.

Qualifique entre 1 e 5