Manage questions & contacts

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

Tipo	Parámetro	Descripción
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.