Recurso de visitas

Esta API recupera información sobre visitas a las publicaciones de 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

TipoParámetroDescripción
EnteroUser_idID de usuario.
CadenaItem_idID de artículo.
FechaDate_fromFecha, en formato ISO, que define el inicio de la consulta.
FechaDate_toFecha, en formato ISO, que define el fin de la consulta.
FechaFinalizaciónOpcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales.
CadenaUnidadUnidad de consulta, valores posibles: [“día”].
EnteroÚltimoOpcional. Denota cuántos días atrás cubrirá la muestra.
Enterototal_visitsVisitas totales a un artículo.
Conjuntovisits_detailVisitas detalladas por país y site.
ConjuntoresultadosDetalle 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. Esto también se aplica a visitas en otras compañías de MercadoLibre, como TuCarro, TuInmueble, Autoplaza, etc.
Recurso:

https://api.mercadolibre.com/users/{User_id}/items_visits?date_from={Date_from}&date_to={Date_to}

Ejemplo:

curl -X GET ‘https://api.mercadolibre.com/users/52366166/items_visits?date_from=2014-06-01T00:00:00.000-00:00&date_to=2014-06-10T00:00:00.000-00:00’

Respuesta:

{
  "user_id": 52366166,
  "date_from": "2014-06-01T00:00:00.000-00:00",
  "date_to": "2014-06-10T00:00:00.000-00:00",
  "total_visits": 120,
  "visits_detail": [
 	{
  	"company": "mercadolibre",
  	"quantity": 59,
	},
   {
  	"company": "tuinmueble",
  	"quantity": 61,
	},
  ],
}

Visitas totales por artículo

Recupera las visitas totales a un artículo entre rangos de fecha y por site.
Recurso:

https://api.mercadolibre.com/items/{Items_id}/visits?date_from={Date_from}&date_to={Date_to}

Ejemplo:

curl -X GET ‘https://api.mercadolibre.com/items/MCO496961166/visits?date_from=2014-04-14T00:00:00.000-03:00&date_to=2014-05-30T23:59:59.999-03:00’

Respuesta:

{
  "item_id": "MCO496961166",
  "date_from": "2014-04-14T00:00:00.000-03:00",
  "date_to": "2014-05-30T23:59:59.999-03:00",
  "total_visits": 152,
  "visits_detail":  [
 	{
  	"company": "mercadolibre",
  	"quantity": 70,
	},
 {
  	"company": "tucarro",
  	"quantity": 82,
	},
  ],
}

Visitas totales por artículo MULTIGET

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

https://api.mercadolibre.com/items/visits?ids={Id1, Id2}date_from={Date_from}&date_to={Date_to}

Ejemplo:

curl -X GET ‘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,
  	},
	],
  },
]

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.
Recurso:

https://api.mercadolibre.com/users/{User_id}/items_visits/time_window?last={Last}&unit={Unit}&ending={Ending}

Ejemplo:

curl -X GET ‘https://api.mercadolibre.com/users/52366166/items_visits/time_window?last=2&unit=day’

Respuesta:

{
  "user_id": 52366166,
  "total_visits": 2083,
  "date_from": "2014-06-10T04:00:00Z",
  "date_to": "2014-06-12T04:00:00Z",
  "last": 2,
  "unit": "day",
  "results": [
 	{
  	"date": "2014-06-10T04:00:00Z",
  	"total": 1637,
  	"visits_detail": [
     	{
      	"company": "mercadolibre",
      	"quantity": 1637,
    	},
  	],
	},
 	{
  	"date": "2014-06-11T04:00:00Z",
  	"total": 446,
  	"visits_detail": [
    	{
      	"company": "mercadolibre",
      	"quantity": 446,
    	},
  	],
	},
  ],
}

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.

Recurso:

https://api.mercadolibre.com/users/{Item_id}/visits/time_window?last={Last}&unit={Unit}&ending={Ending}

Ejemplo:

curl -X GET ‘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,
    	},
  	],
	},
  ],
}

Visitas con fecha por artículo MULTIGET

Recupera las visitas de acuerdo con un conjunto de artículos (máximo 50), por site. El detalle de la información está agrupado por intervalos de tiempo.
Recurso:

https://api.mercadolibre.com/items/visits/time_window?ids={Id1, Id2}last={Last}&unit={Unit}&ending={Ending}

Ejemplo:

curl -X GET ‘https://api.mercadolibre.com/items/visits/time_window?ids=MLA506635149,MLA506634973,MLA503004418&last=3&unit=day‘

Respuesta:

[
 {
 "item_id": "MLA506635149",
 "total_visits": 0,
 "date_from": "2015-08-30T04:00:00Z",
 "date_to": "2015-09-02T04:00:00Z",
 "last": 3,
 "unit": "day",
 "results": [
 {
 "date": "2015-08-30T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-08-31T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-09-01T04:00:00Z",
 "total": 0,
 "visits_detail": []
 }
 ]
 },
 {
 "item_id": "MLA506634973",
 "total_visits": 0,
 "date_from": "2015-08-30T04:00:00Z",
 "date_to": "2015-09-02T04:00:00Z",
 "last": 3,
 "unit": "day",
 "results": [
 {
 "date": "2015-08-30T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-08-31T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-09-01T04:00:00Z",
 "total": 0,
 "visits_detail": []
 }
 ]
 },
 {
 "item_id": "MLA503004418",
 "total_visits": 169,
 "date_from": "2015-08-30T04:00:00Z",
 "date_to": "2015-09-02T04:00:00Z",
 "last": 3,
 "unit": "day",
 "results": [
 {
 "date": "2015-08-30T04:00:00Z",
 "total": 42,
 "visits_detail": [
 {
 "company": "mercadolibre",
 "quantity": 42
 }
 ]
 },
 {
 "date": "2015-08-31T04:00:00Z",
 "total": 38,
 "visits_detail": [
 {
 "company": "mercadolibre",
 "quantity": 38
 }
 ]
 },
 {
 "date": "2015-09-01T04:00:00Z",
 "total": 89,
 "visits_detail": [
 {
 "company": "mercadolibre",
 "quantity": 89
 }
 ]
 }
 ]
 }
]

Si necesitas más información sobre republicaciones, por favor consulta el tutorial re-publica tus items.

Por favor califica del 1 al 5