API Docs
Recursos de la API
Métricas

Ú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.