Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 13/11/2023

Visitas

Importante
Desde el 2 de agosto de 2021:

- Cambia la forma en que se contabilizan las visitas, serán únicas por día
- Se desactivará Multiget en /visits/items
- La cantidad de visitas estarán disponibles dentro de las 48 hs 
- El rango de tiempo para consultar las visitas será de 150 días

Con este recurso puedes obtener la información sobre visitas de publicaciones en Mercado Libre. Puedes consultar datos por ventanas de tiempo y sites. Recuerda que al volver a publicar se heredan las visitas históricas del parent_item, sin importar cuántas veces se vuelva a publicar.


Descripción de parámetros

Tipo Parámetro Descripción
Integer user_id ID de usuario.
String item_id ID de artículo.
Date date_from Fecha, en formato ISO, que define el inicio de la consulta. El máximo es de 150 días.
Date date_to Fecha, en formato ISO, que define el fin de la consulta. El máximo es de 150 días.
Date ending Opcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales.
String unit Unidad de consulta, valores posibles: [“day”].
Integer last Opcional. Denota cuántos días atrás cubrirá la muestra.
Integer total_visits Visitas totales a un artículo.
Array visits_detail Visitas detalladas por país y site.
Array result Detalle de visitas agrupadas por intervalos de tiempo. La Unidad del parámetro define la longitud.


Visitas totales por usuario

Recupera las visitas totales que recibe un usuario entre rangos de fechas.
Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items_visits?date_from=$DATE_FROM&date_to=$DATE_TO

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/1000011398/items_visits?date_from=2021-01-01&date_to=2021-02-01

Respuesta:

{
  "user_id": 1000011398,
  "date_from": "2021-01-01T00:00:00Z",
  "date_to": "2021-02-01T00:00:00Z",
  "total_visits": 323690,
  "visits_detail": [
    {
      "company": "mercadolibre",
      "quantity": 323690
    }
  ]
}


Visitas totales por artículo

Recupera las visitas totales a un artículo de los últimos dos años.
Llamada:

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

Ejemplo:

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

Respuesta:

{
  "MLB9992242141": 552
}


Visitas por artículo entre rangos de fecha

Recupera las visitas totales de acuerdo con un conjunto de artículos concatenados dentro de un rango de fechas, por site.
Llamada:

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

Ejemplo:

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

Respuesta:


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


Visitas con fecha por usuario

Recupera las visitas de un usuario a cada artículo para cierta ventana de tiempo, por site. El detalle de la información está agrupado por intervalos de tiempo.
Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/1000011398/items_visits/time_window?last=2&unit=day

Respuesta:

{
  "user_id": 1000011398,
  "date_from": "2021-01-08T00:00:00Z",
  "date_to": "2021-01-10T00:00:00Z",
  "total_visits": 2923,
  "last": 2,
  "unit": "day",
  "results": [
    {
      "date": "2021-01-08T00:00:00Z",
      "total": 2205,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 2205
        }
      ]
    },
    {
      "date": "2021-01-09T00:00:00Z",
      "total": 718,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 718
        }
      ]
    }
  ]
}


Visitas con fecha por artículo

Recupera las visitas a un artículo para cierta ventana de tiempo, por site. El detalle de la información está agrupado por intervalos de tiempo.
Llamada:

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

Ejemplo:

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

Respuesta:

{
  "item_id": "MCO471870973",
  "date_from": "2021-08-04T00:00:00Z",
  "date_to": "2021-08-06T00:00:00Z",
  "total_visits": 26,
  "last": 2,
  "unit": "day",
  "results": [
    {
      "date": "2021-08-04T00:00:00Z",
      "total": 16,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 16
        }
      ]
    },
    {
      "date": "2021-08-05T00:00:00Z",
      "total": 10,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 10
        }
      ]
    }
  ]
}