Manage questions & contacts

When users browse classified items (real state, cars and services), they are able to contact the item’s owner through a form displayed on the listing or they can see the owner’s phone (see phone). In the event of a question, when made, it is automatically sent to the message inbox, within the client account in Mercado Libre. It is very important that your integration reads the questions, and also enables users to answer them through your system. In order to learn how to manage questions and answers (leads), check our guide of Questions and answers management. Here you will find all the necessary content to execute the integration of leads of Mercado Libre. Apart from the guide mentioned above, you can check data on questions and record the number of clicks the option “See telephone” got. These methods are detailed below.

Classified contacts guide

This guide will help you to collect data about questions and phone views on your classified items. Is a read only API, very useful to take metrics of your classified items. You can query data about questions, and keep a record of how many times the ‘See phone’ option was clicked on. You can query by user, item, dates and time windows.

Contents:

  • Parameters description
  • Total questions
  • Questions dated
  • Contact phone totals
  • Contact phone dated

Parameters description

Type Parameter Description
Integer {userId} User id.
Integer {itemId} Item id.
Date {dateFrom} Date, ISO format, that defines the start of the query.
Date {dateTo} Date, ISO format, that defines the end of the query.
Integer {limit} Optional. Max amount of items to return.
Integer {offset} Optional. Pagination.
Integer {last} Optional. Denotes how many hours/days back the sample will cover.
String {unit} Query unit, possible values: [ “day” , “hour”].
Date {ending} Optional. Date, ISO format, which states the time of completion of the sample, by default it’s the current date and time.
String {order} Optional. It’s sorts the results by date: [“desc”, “asc”] (by default it’s “asc”).

Total questions

You can get the total questions an specific item had, or the total questions a seller had in all of his items between a date range.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}
Example:
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
}

Questions dated

This resource let you get the questions on an specific item or by seller for a certain time window. Besides, you get details about contacts made on guest mode (unlogged or unregistered users) in between time intervals, by hour or by day.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}
If you need to concatenate items, do the following:
curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?ids={id1,id2}&last={Last}&unit={Unit}&ending={Ending_date}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}
Example:
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
        }
    ]
}

Contacts phone totals

You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user between date ranges.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}
Example:
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"
}

Contacts phone dated

You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user for a certain time window. Besides providing the total visits, the information is detailed and grouped by time intervals.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}
If you need to concatenate items:
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}
Example:
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
            }
        ]
    }
]

Next topic: Subscribe to our feeds.

Be part of our community