Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 15/12/2025

Trends

With the resource /trends you can find out which are the 50 products most sought after by users in Mercado Libre. The trends are updated weekly (Argentina, Brazil, Chile, Mexico, Colombia, Uruguay, Peru) and you can also query them as follows.

Note: The API integrates 3 criteria
- The fastest growing searches are calculated over the last 2 weeks. (A comparison of both weeks is performed)
- The most wanted and most popular searches are the result of the last week.
This information is renewed weekly.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/trends/$SITE_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/trends/MLA

Response:

[
 {
   "keyword": "alfombras",
   "url": "https://hogar.mercadolibre.com.ar/textiles-decoracion-alfombras-carpetas/alfombras"
 },
 {
   "keyword": "lavarropa automatico",
   "url": "https://listado.mercadolibre.com.ar/lavado-lavarropas-lavasecarropas/lavarropas-automaticos"
 },
 {
   "keyword": "smart tv 32",
   "url": "https://televisores.mercadolibre.com.ar/televisores/smart-tv-32"
 },
 {
   "keyword": "celular xiaomi",
   "url": "https://celulares.mercadolibre.com.ar/xiaomi"
 },
 {
   "keyword": "xbox series x",
   "url": "https://listado.mercadolibre.com.ar/xbox-series-x"
 }
]

Response fields

This service returns an array of 50 objects in JSON format, organized as follows:

  • First 10 elements: correspond to the searches with the highest growth.
  • Next 20 elements: represent the most wanted searches by users.
  • Last 20 elements: show the most popular trends of the week.

Each object within the array contains the following fields:

  • keyword (String): Term or product that users have searched for.
  • url (String): Link that directs to the search results related to that term.

If you also want to know what the trends are in a specific category, you must add the {category_id} parameter in addition to the country.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/trends/$SITE_ID/$CATEGORY_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/trends/MLA/MLA1246

Response:

[
 {
   "keyword": "mesa manicura plegable",
   "url": "https://listado.mercadolibre.com.ar/mesa-manicura-plegable#trend"
 },
 {
   "keyword": "afeitadora cleancut",
   "url": "https://listado.mercadolibre.com.ar/afeitadora-cleancut#trend"
 },
 {
   "keyword": "kit de barberia",
   "url": "https://listado.mercadolibre.com.ar/kit-de-barberia#trend"
 },
 {
   "keyword": "natura",
   "url": "https://listado.mercadolibre.com.ar/natura#trend"
 },
 {
   "keyword": "philips one blade",
   "url": "https://listado.mercadolibre.com.ar/philips-one-blade#trend"
 }
]

Errors

The following table lists the possible errors returned by the Trends API:

Status_code Error code Error message Description
400 bad_request Malformed access_token: $TOKEN When the access token is invalid or malformed.
403 Not authorized Not authorized for public trends When the user does not have authorization to access trends.
404 Not found Not found public trends When the site ID or category ID is invalid or does not exist.
404 route_not_found Route /trends/ not found When the $SITE_ID parameter is not included in the request.