Última actualización 15/03/2023

Métricas

Este ejemplo servirá para conocer nuestro recurso de métricas.

Recurso Descripción Ejemplo
/users/$USER_ID/items_visits?date_from=$DATE_FROM&date_to=$DATE_TO Devuelve el número de visitas que un usuario ha tenido. GET
Go back X

Obtiene visitas por usuario

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/items_visits?date_from=2016-01-01T00:00:00.000-00:00&date_to=2016-02-10T00:00:00.000-00:00
 

Respuesta

{
  "user_id": 206946886,
  "date_from": "2016-01-01T00:00:00.000-00:00",
  "date_to": "2016-02-10T00:00:00.000-00:00",
  "total_visits": 0,
  "visits_detail": [
  ]
}
Leer más.
/users/$USER_ID/items_visits/time_window?last=$LAST&UNIT=$UNIT&ENDING=$ENDING Devuelve las visitas de un usuario en cada item publicado durante un período de tiempo, por sitio. El detalle de la información se agrupa por intervalos de tiempo. GET
Go back X

Obtiene visitas por usuario y tiempo.

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

Respuesta

{
    "user_id": 52366166,
    "date_from": "2021-06-16T00:00:00Z",
    "date_to": "2021-06-18T00:00:00Z",
    "total_visits": 0,
    "last": 2,
    "unit": "day",
    "results": [
        {
            "date": "2021-06-16T00:00:00Z",
            "total": 0,
            "visits_detail": []
        },
        {
            "date": "2021-06-17T00:00:00Z",
            "total": 0,
            "visits_detail": []
        }
    ]
}
Leer más.
/users/$USER_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO Devuelve el total de las preguntas de un usuario específico en todos los ítems publicados en un intervalo de fechas. GET
Go back X

Obtiene el total de preguntas por usuario.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999
 

Respuesta

{
    "date_from": "2014-08-01T00:00:00.000-03:00",
    "date_to": "2014-08-02T23:59:59.999",
    "item_id": "MLV421672596",
    "total": 9
}
Leer más.
/users/$USER_ID/contacts/questions/time_window?last=$LAST&UNIT=$UNIT Este recurso le permite obtener las preguntas realizadas en un determinado tiempo en los ítems publicado por un vendedor. GET
Go back X

Obtiene las preguntas realizadas en un período de tiempo en los ítems publicados por un vendedor.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
 

Respuesta

{
    "total": 0,
    "last": "2",
    "unit": "hour",
    "date_from": "2021-06-18T18:00:00Z",
    "date_to": "2021-06-18T20:00:00Z",
    "item_id": "MLA510272257",
    "results": [
        {
            "date": "2021-06-18T18:00:00Z",
            "total": 0
        },
        {
            "date": "2021-06-18T19:00:00Z",
            "total": 0
        }
    ]
}
Leer más.
/users/$USER_ID/contacts/questions/time_window?last=$LAST&UNIT=$UNIT Este recurso le permite obtener las preguntas realizadas en un determinado tiempo en el ítem publicado por un vendedor. GET
Go back X

Obtener los contactos recibidos por el vendedor en sus ítems clasificados dentro de un período de tiempo.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
 

Respuesta

{
    "total": 0,
    "last": "2",
    "unit": "hour",
    "date_from": "2021-06-18T18:00:00Z",
    "date_to": "2021-06-18T20:00:00Z",
    "item_id": "MLA510272257",
    "results": [
        {
            "date": "2021-06-18T18:00:00Z",
            "total": 0
        },
        {
            "date": "2021-06-18T19:00:00Z",
            "total": 0
        }
    ]
}
Leer más.
/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&DATE_TO=$DATE_TO Puede obtener la cantidad de veces que hicieron clic en "Ver teléfono" dentro de un ítem durante un período de tiempo. GET
Go back X

Obtener "ver teléfono" en un rango de fecha.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999
 

Respuesta

{
    "date_from": "2014-05-28T00:00:00.000-03:00",
    "date_to": "2014-05-29T23:59:59.999",
    "total": 71,
    "user_id": "52366166"
}
Leer más.
/users/$USER_ID/contacts/phone_views/time_window?last=$LAST&UNIT=$UNIT Puede obtener la cantidad de veces que fue clickeada la opción "Ver teléfono" para cada ítem de un usuario en un rango de fechas. GET
Go back X

Get "See Phone" views within a time window.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00
 

Respuesta

[
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA510272257",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA489747739",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    }
]
Leer más.
/items/visits?ids=$ID1, ID2&date_from=$DATE_FROM&date_to=$DATE_TO Devuelve las visitas del ítem (Multi-Get). GET
Go back X

>Devuelve las visitas del ítem (Multi-Get).

 curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits?ids=MLA506635149,MLA506634973,MLA503004418&date_from=2014-06-01T00:00:00.000-00:00&date_to=2014-06-10T00:00:00.000-00:00
 

Respuesta

[
 {
    "item_id": "MLA506635149",
    "date_from": "2014-06-01T00:00:00.000-00:00",
    "date_to": "2014-06-10T00:00:00.000-00:00",
    "total_visits": 134,
    "visits_detail":  [
       {
        "company": "mercadolibre",
        "quantity": 134,
      },
    ],
  },
   {
    "item_id": "MLA506634973",
    "date_from": "2014-06-01T00:00:00.000-00:00",
    "date_to": "2014-06-10T00:00:00.000-00:00",
    "total_visits": 122,
    "visits_detail": [
       {
        "company": "mercadolibre",
        "quantity": 122,
      },
    ],
  },
   {
    "item_id": "MLA503004418",
    "date_from": "2014-06-01T00:00:00.000-00:00",
    "date_to": "2014-06-10T00:00:00.000-00:00",
    "total_visits": 355,
    "visits_detail": [
       {
        "company": "mercadolibre",
        "quantity": 355,
      },
    ],
  },
]
Learn more.
/items/$ITEM_ID/visits/time_window?last=$LAST&UNIT=$UNIT&ENDING=$ENDING Devuelve las visitas del ítem en un período de tiempo filtrando por unidad y el parámetro de finalización. GET
Go back X

Obtiene las visitas de un ítem.

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

Respuesta

{
  "item_id": "MLA506635149",
  "total_visits": 15,
  "date_from": "2014-06-09T04:00:00Z",
  "date_to": "2014-06-11T04:00:00Z",
  "last": 2,
  "unit": "day",
  "results": [
     {
      "date": "2014-06-09T04:00:00Z",
      "total": 10,
      "visits_detail": - [
         {
          "company": "mercadolibre",
          "quantity": 10,
        },
      ],
    },
     {
      "date": "2014-06-10T04:00:00ZZ",
      "total": 5,
      "visits_detail": - [
         {
          "company": "mercadolibre",
          "quantity": 5,
        },
      ],
    },
  ],
}
Leer más.
/items/visits/time_window?ids=$ID1, ID2last=$LAST&UNIT=UNIT&ENDING=$ENDING Devuelve múltiples visitas del ítem en un período de tiempo filtrando por unidad y el parámetro de finalización.(Multi Get). GET
Go back X

Obtiene las visitas del ítem. (Multi Get)

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits/time_window?ids=MLA506635149,MLA506634973,MLA503004418&last=3&unit=day
 

Respuesta

[
    {
        "item_id": "MLA506635149",
        "date_from": "2021-06-15T00:00:00Z",
        "date_to": "2021-06-18T00:00:00Z",
        "total_visits": 0,
        "last": 3,
        "unit": "day",
        "results": [
            {
                "date": "2021-06-15T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-16T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-17T00:00:00Z",
                "total": 0,
                "visits_detail": []
            }
        ]
    },
    {
        "item_id": "MLA506634973",
        "date_from": "2021-06-15T00:00:00Z",
        "date_to": "2021-06-18T00:00:00Z",
        "total_visits": 0,
        "last": 3,
        "unit": "day",
        "results": [
            {
                "date": "2021-06-15T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-16T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-17T00:00:00Z",
                "total": 0,
                "visits_detail": []
            }
        ]
    },
    {
        "item_id": "MLA503004418",
        "date_from": "2021-06-15T00:00:00Z",
        "date_to": "2021-06-18T00:00:00Z",
        "total_visits": 0,
        "last": 3,
        "unit": "day",
        "results": [
            {
                "date": "2021-06-15T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-16T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-17T00:00:00Z",
                "total": 0,
                "visits_detail": []
            }
        ]
    }
]
Leer más.
/items/contacts/phone_views/time_window?ids=$ID1,ID2&last=$LAST&UNIT=$UNIT&ENDING=ENDING_DATE Devuelve el número de usuarios que ha hecho clic en "Ver teléfono" en varios ítems durante un período de tiempo (Multi Get). GET
Go back X

Obtener las vistas de "Ver teléfono".

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00
 

Respuesta

[
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA510272257",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA489747739",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    }
]
Leer más.