Visits

Parameters

• item_id (String): Item ID.
• date_from (String): Date in ISO format that defines the start of the query. Maximum range is 150 days.
• date_to (String): Date in ISO format that defines the end of the query. Maximum range is 150 days.
• ending (String, optional): Date in ISO format YYYY-MM-DD which states the time of completion of the sample. Defaults to current date and time.
• unit (String): Query unit. Possible values: day.
• last (Integer, optional): How many last days define the test.

Response Fields

• total_visits (Integer): Total visits on an item.
• visits_detail (Array): Visits detailed by company.
• results (Array): Visits detail grouped by time intervals. The length is defined by the unit parameter.

Total visits by item

Retrieve total visits to an article of the last two years.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/visits/items?ids=$ITEM_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/visits/items?ids=MLB9992242141

Response:

{
  "MLB9992242141": 552
}

Total visits by item between date ranges

Retrieves total visits on an item between date ranges and by site.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits?ids=$ITEM_ID&date_from=$DATE_FROM&date_to=$DATE_TO

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits?ids=MCO473861358&date_from=2021-01-01&date_to=2021-02-01

Response:

{
  "item_id": "MCO473861358",
  "date_from": "2021-01-01T00:00:00Z",
  "date_to": "2021-02-01T00:00:00Z",
  "total_visits": 536,
  "visits_detail": [
    {
      "company": "mercadolibre",
      "quantity": 536
    }
  ]
}

Dated visits by item

Retrieves visits on an item for a certain time window, by site. The information detail is grouped by time intervals.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/visits/time_window?last=$LAST&unit=$UNIT&ending=$ENDING

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MCO471870973/visits/time_window?last=2&unit=day&ending=2025-12-29

Response:

{
  "item_id": "MCO471870973",
  "date_from": "2025-12-27T00:00:00Z",
  "date_to": "2025-12-29T00:00:00Z",
  "total_visits": 26,
  "last": 2,
  "unit": "day",
  "results": [
    {
      "date": "2025-12-27T00:00:00Z",
      "total": 16,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 16
        }
      ]
    },
    {
      "date": "2025-12-28T00:00:00Z",
      "total": 10,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 10
        }
      ]
    }
  ]
}

Errors

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