Metrics

This examples will teach you how to use our resources to take metrics.

Recurso Description Example
/users/{User_id}/items_visits?date_from={Date_from}&date_to={Date_to} Returns how many visits a users had. GET
Go back X

Get visits by user

curl -X GET 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
 

Response

{
  "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": [
  ]
}
Learn more.
/users/{User_id}/items_visits/time_window?last={Last}&unit={Unit}&ending={Ending} Retrieves visits on every classified item of an user for a certain time window, by site. The information detail it’s grouped by time intervals. GET
Go back X

Get visits by user and time.

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

Response

{
  "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,
        },
      ],
    },
  ],
}
Learn more.
/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to} Retrieve the total questions an specific user had in all of his classified items between a date range. GET
Go back X

Get total amount of questions by user.

curl -X GET 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
 

Response

{
    "date_from": "2014-08-01T00:00:00.000-03:00",
    "date_to": "2014-08-02T23:59:59.999",
    "item_id": "MLV421672596",
    "total": 9
}
Learn more.
/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit} This resource let you get the questions made on a seller classified items for a certain time window. GET
Go back X

Get questions made on a seller classified items within a time window.

curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
 

Response

          
{
    "item_id": "MLA510272257",
    "total": 0,
    "date_from": "2014-08-06T12:00:00Z",
    "date_to": "2014-08-06T14:00:00Z",
    "last": 2,
    "unit": "hour",
    "results": [
        {
            "date": "2014-08-06T12:00:00Z",
            "total": 0
        },
        {
            "date": "2014-08-06T13:00:00Z",
            "total": 0
        }
    ]
}
Learn more.
/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit} This resource let you get the questions made on a seller classified item for a certain time window. GET
Go back X

Get contacts received by seller for his classified items within a time window.

curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
 

Respuesta

{
    "item_id": "MLA510272257",
    "total": 0,
    "date_from": "2014-08-06T12:00:00Z",
    "date_to": "2014-08-06T14:00:00Z",
    "last": 2,
    "unit": "hour",
    "results": [
        {
            "date": "2014-08-06T12:00:00Z",
            "total": 0
        },
        {
            "date": "2014-08-06T13:00:00Z",
            "total": 0
        }
    ]
}
Learn more.
/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to} You can get the total times the ‘See phone’ option was clicked for every item of an user between date ranges. GET
Go back X

Get "See phone" views by date.

curl -X GET 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
 

Response

{
    "date_from": "2014-05-28T00:00:00.000-03:00",
    "date_to": "2014-05-29T23:59:59.999",
    "total": 71,
    "user_id": "52366166"
}
Learn more.
/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit} You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user on a time window. GET
Go back X

Get "See Phone" views within a time window.

curl -X GET 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
 

Response

[
    {
        "item_id": "MLA510272257",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "item_id": "MLA489747739",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    }
]
Learn more.
/items/visits?ids={Id1, Id2}&date_from={Date_from}&date_to={Date_to} Retrieves item's visits (Multi-Get). GET
Go back X

>Retrieves item's visits (Multi Get)

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’
 

Response

[
 {
    "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} Retrieves item's visits on a time window filtering by unit and ending parameters. GET
Go back X

Get item's visits.

curl -X GET ‘https://api.mercadolibre.com/items/MLA506635149/visits/time_window?last=2&unit=day&ending=2014-06-11
 

Response

{
  "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,
        },
      ],
    },
  ],
}
Learn more.
/items/visits/time_window?ids={Id1, Id2}last={Last}&unit={Unit}&ending={Ending} Retrieves multiple item's visits on a time window filtering by unit and ending parameters(Multi Get). GET
Go back X

Get item's visits (Multi Get)

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

Response

[
 {
  "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
    }
  ]
 }
 ]
 }
]
Learn more.
/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date} Retrieves how many time user's clicked on "See phone" for multiple items (Multi Get). GET
Go back X

Get "See Phone" views.

curl -X GET 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
 

Response

[
    {
        "item_id": "MLA510272257",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "item_id": "MLA489747739",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    }
]
Learn more.
or register to recieve the latest news about our API