Estatísticas de interações em Imóveis

Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.

Última atualização em 09/11/2025

Estatísticas de Interações em Imóveis

Quando os usuários do Mercado Livre interagem com publicações de imóveis, são geradas estatísticas que permitem aos vendedores (sellers) tomar decisões sobre a gestão de seu inventário. Nesta seção MLA, abordaremos os tipos de interações que um usuário pode ter em uma publicação e os recursos da nossa API que permitem saber quantas dessas interações são geradas.

Tipos de Interações

Quando os usuários acessam uma publicação, é gerado o primeiro registro de interação — uma visita. Dependendo do interesse do usuário no imóvel, essa visita pode evoluir para:

Contato ou pergunta: É a interação em que um usuário acessa o botão de contato ou a seção de perguntas e deixa um comentário.
WhatsApp: É a interação em que um usuário seleciona o botão do WhatsApp (desde que o vendedor tenha registrado um número de telefone na publicação) e é direcionado para um chat com o seller, seja no WhatsApp Web ou na versão móvel.
Telefone: É a interação em que o usuário seleciona o botão “Ver número de telefone”, o qual exibe o número de contato do vendedor.
Cotações: O comprador tem a possibilidade de solicitar uma cotação para se informar sobre os detalhes e o valor do imóvel no qual está interessado. Uma cotação ocorre quando o interessado realiza uma consulta em um anúncio.

As interações nas publicações são independentes entre si. Portanto, um mesmo usuário pode gerar várias interações simultaneamente — como uma visita, uma pergunta, visualizar o número de telefone ou iniciar um chat via WhatsApp.

Importante:

Nesta guia, veremos recursos que permitem apenas visualizar as quantidades dessas interações. Se você precisar obter informações de contato dos usuários para os vendedores, consulte a seção de Leads.

Visitas

Visitas por vendedor — total de visitas entre intervalos de datas

Para obter a quantidade de visitas que um vendedor recebeu em um determinado intervalo de datas, utilize a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$USER_ID/items_visits?date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetros

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor (seller) a ser consultado
$DATE_TO	date (ISO 8601)	Sim	Data inicial a partir da qual as visitas são contabilizadas, no formato YYYY-mm-dd. Exemplo: 2021-01-01.
$DATE_FROM	date (ISO 8601)	Sim	Data final até a qual as visitas são contabilizadas, no formato YYYY-mm-dd. Exemplo: 2021-02-01.

A resposta será semelhante a esta:

{
  "user_id": 1000011398,
  "date_from": "2021-01-01T00:00:00Z",
  "date_to": "2021-02-01T00:00:00Z",
  "total_visits": 690,
  "visits_detail": [
    {
      "company": "mercadolibre",
      "quantity": 690
    }
  ]
}

Parâmetro	Tipo	Descrição
user_id	number	Identificador do usuário (seller) para o qual foram recuperadas as estatísticas de visitas.
date_from	date/time	Data inicial do intervalo de tempo para as visitas.
date_to	date/time	Data final do intervalo de tempo para as visitas.
total_visits	number	Número total de visitas recebidas pelo usuário durante o período especificado.
visits_detail	array	Detalhes das visitas, incluindo a origem (empresa) e a quantidade de visitas.
company	string	Nome da empresa associada à origem das visitas.
quantity	number	Quantidade de visitas registradas.

Quantidade de visitas recentes por usuário

Para obter a quantidade de visitas recentes, execute a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$USER_ID/items_visits/time_window?last=$LAST&unit=$UNIT&ending=$ENDING'

Parâmetros

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor (seller)
$LAST	option	Sim	Última quantidade de tempo definida em unit, por exemplo `last=2&unit=day` (últimos 2 dias).
$UNIT	integer	Sim	Unidades de tempo, por exemplo `unit=day` (padrão) ou `hour`.
$ENDING	date (ISO 8601)	Sim	Data ISO limite para a contagem. Caso não seja informada, será usada a data e hora atuais da consulta.

Exemplo de resposta:

{
  "user_id": 1765562240,
  "date_from": "2025-03-04T00:00:00-04:00",
  "date_to": "2025-03-16T00:00:00-04:00",
  "total_visits": 20,
  "last": 12,
  "unit": "day",
  "results": [
    {
      "date": "2025-03-10T00:00:00Z",
      "total": 4,
      "visits_detail": [
        { "company": "mercadolibre", "quantity": 4 }
      ]
    },
    {
      "date": "2025-03-13T00:00:00Z",
      "total": 2,
      "visits_detail": [
        { "company": "mercadolibre", "quantity": 2 }
      ]
    }
  ]
}

Parâmetro	Tipo	Descrição
user_id	number	Identificador do usuário (seller) para o qual foram recuperadas as estatísticas de visitas.
date_from	date/time	Data inicial do intervalo de tempo considerado para as visitas.
date_to	date/time	Data final do intervalo de tempo considerado para as visitas.
total_visits	number	Número total de visitas recebidas pelo usuário durante o intervalo de tempo especificado.
last	number	Quantidade de tempo mais recente definida na unidade especificada.
unit	string	Unidade de tempo utilizada (por exemplo, "day").
results	array	Lista de objetos contendo os dados dos resultados por dia.
results[n].date	date/time	Data específica do resultado dentro do período considerado.
results[n].total	number	Número total de visitas associadas à data específica do resultado.
results[n].visits_detail[m].company	string	Nome da empresa associada às visitas em uma data específica.
results[n].visits_detail[m].quantity	number	Quantidade de visitas registradas para uma empresa em uma data específica.

Visitas por publicação

Todas as visitas de uma publicação

Para obter todas as visitas que um imóvel recebeu, basta ter o ID da publicação e executar o seguinte comando:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/visits/items?ids=$ITEM_ID'

Parâmetros

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$ITEM_ID	string	Não	ID da publicação

Exemplo de resposta:

{
  "MLA123456789": 98
}

Total entre intervalos de datas

Para obter as visitas que um imóvel recebeu dentro de um intervalo de datas, utilize o comando abaixo com o ID da publicação e as datas desejadas:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/items/visits?ids=$ITEM_ID&date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetros

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$ITEM_ID	string	Não	ID da publicação
$DATE_TO	date (ISO 8601)	Sim	Data inicial a partir da qual as visitas são contadas, no formato YYYY-mm-dd, por exemplo: 2021-01-01.
$DATE_FROM	date (ISO 8601)	Sim	Data final até a qual as visitas são contadas, no formato YYYY-mm-dd, por exemplo: 2021-01-01.

A resposta será semelhante às anteriores.

{
  "item_id": "MLA473861358",
  "date_from": "2025-01-01T00:00:00Z",
  "date_to": "2025-02-01T00:00:00Z",
  "total_visits": 536,
  "visits_detail": [
    { "company": "mercadolibre", "quantity": 536 }
  ]
}

Perguntas

Você pode obter o número total de perguntas feitas em uma publicação específica ou o total de perguntas que um vendedor recebeu em todas as suas publicações dentro de um determinado período de tempo. A seguir, listamos as consultas possíveis.

Perguntas por Publicação

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetros

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$ITEM_ID	string	Não	ID da publicação
$DATE_TO	date (ISO 8601)	Sim	Data inicial do intervalo a ser consultado, no formato YYYY-mm-dd, por exemplo: 2021-01-01.
$DATE_FROM	date (ISO 8601)	Sim	Data final do intervalo a ser consultado, no formato YYYY-mm-dd, por exemplo: 2021-01-01.

Você obterá um resultado semelhante ao exemplo a seguir:

{
  "date_from": "2014-08-01T00:00:00.000-03:00",
  "date_to": "2014-08-02T23:59:59.999",
  "item_id": "MLA421672596",
  "total": 9
}

Parâmetro	Tipo	Descrição
date_from	String	Data inicial do período do relatório.
date_to	String	Data final do período do relatório.
item_id	String	ID do item.
total	Int	Número total de perguntas sobre o item nesse período.

Perguntas associadas a um usuário

Você pode consultar a quantidade de perguntas associadas a um usuário realizando a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$USER_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetro	Tipo	Opcional	Valores / Descrição
ACCESS_TOKEN	string	Não	Lembre-se de utilizar o token que você gerou no guia de configuração
USER_ID	String	Não	ID do usuário a ser consultado
$DATE_TO	date (ISO 8601)	Sim	Data inicial do intervalo a ser consultado
$DATE_FROM	date (ISO 8601)	Sim	Data final do intervalo a ser consultado

A resposta obtida será semelhante à mencionada anteriormente, mas neste caso estará focada no usuário em vez do item.

{
  "date_from": "2025-01-01T00:00:00.000-03:00",
  "date_to": "2025-01-31T23:59:59.999",
  "user_id": "1672596785",
  "total": 5
}

Perguntas recentes

Você pode obter a quantidade de perguntas em uma determinada janela de tempo, por meio da seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$USER_ID/contacts/questions/time_window?last=$LAST&unit=$UNIT&ending=$ENDING'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor
$LAST	option	Sim	Quantidade de tempo definida em unit, por exemplo `last=2&unit=day` (Últimos 2 dias).
$UNIT	integer	Sim	Unidades de tempo, por exemplo `unit=day` (padrão) ou `hour`.
$ENDING	date (ISO 8601)	Sim	Data ISO limite para a contagem. Se não for informada, será considerada a data e hora atuais.

O resultado é semelhante aos anteriores:

{
  "user_id": "510272257",
  "total": 5,
  "date_from": "2025-06-06T12:00:00Z",
  "date_to": "2025-06-06T14:00:00Z",
  "last": 2,
  "unit": "hour",
  "results": [
    { "date": "2025-06-06T13:00:00Z", "total": 3 },
    { "date": "2025-06-06T14:00:00Z", "total": 2 }
  ]
}

Telefone

De forma semelhante à consulta do número de perguntas feitas a um item, é possível visualizar a quantidade total de cliques em 'Ver telefone' de uma publicação ou de todas as publicações de um usuário dentro de um intervalo de datas. A seguir, apresentamos as consultas disponíveis relacionadas ao telefone.

Solicitações de telefone por publicação

Você pode consultar a quantidade de interações que ocorreram com o telefone de um item dentro de um intervalo de datas, realizando a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$ITEM_ID	string	Não	ID do item
$DATE_TO	date (ISO 8601)	Sim	Data inicial do intervalo a ser consultado
$DATE_FROM	date (ISO 8601)	Sim	Data final do intervalo a ser consultado

Resposta:

{
  "date_from": "2025-01-13T00:00:00.000-03:00",
  "date_to": "2025-06-01T23:59:59.999",
  "total": 2,
  "item_id": "MLA52366166"
}

Parâmetro	Tipo	Descrição
date_from	String	Data inicial do período do relatório.
date_to	String	Data final do período do relatório.
item_id	String	ID do item.
total	Int	Número total de cliques em “Ver telefone” do item neste período.

Solicitações de telefone por usuário

Da mesma forma, você pode consultar a quantidade de interações com o telefone associadas a um usuário, realizando a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do usuário
$DATE_TO	date (ISO 8601)	Sim	Data inicial do intervalo a ser consultado
$DATE_FROM	date (ISO 8601)	Sim	Data final do intervalo a ser consultado

Resposta:

{
  "date_from": "2025-01-01T00:00:00.000-03:00",
  "date_to": "2025-05-29T23:59:59.999",
  "total": 71,
  "user_id": "52366166"
}

Usos recentes do botão de telefone

Acesse o número total de cliques em “Ver telefone” de um anúncio ou de todos os anúncios de um usuário em um período determinado. Além do total de cliques, os dados são detalhados e organizados por períodos de tempo.

Relacionadas a um usuário, a obtenção é feita da seguinte forma:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT&ending=$ENDING'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor
$LAST	option	Sim	Quantidade de tempo definida em `unit`, por exemplo `last=2&unit=day`. Indica os últimos 2 dias.
$UNIT	integer	Sim	Unidade de tempo, por exemplo `unit=day` (padrão). Outra opção possível é `hour`.
$ENDING	date (ISO 8601)	Sim	Data ISO limite para a contagem. Caso não seja informada, será considerada a data e hora atuais.

Relacionadas a um item, a consulta é feita com a chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT&ending=$ENDING'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor
$LAST	option	Sim	Quantidade de tempo definida em `unit`, por exemplo `last=2&unit=day`. Indica os últimos 2 dias.
$UNIT	integer	Sim	Unidade de tempo, por exemplo `unit=day` (padrão). Outra opção possível é `hour`.
$ENDING	date (ISO 8601)	Sim	Data ISO limite para a contagem. Caso não seja informada, será considerada a data e hora atuais.

Você pode concatenar vários IDs de itens separados por vírgula da seguinte maneira:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=$ID1,ID2&last=$LAST&unit=$UNIT&ending=$ENDING_NOTE'

Em qualquer um dos dois casos, você obterá uma resposta semelhante à seguinte:

[
  {
    "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 }
    ]
  }
]

Também é possível consultar o número total de cliques na opção de WhatsApp de uma publicação ou para cada anúncio de um usuário dentro de um período de datas específico.

Redirecionamentos para WhatsApp por usuário

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  \
'https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor
$DATE_TO	date (ISO 8601)	Sim	Data inicial do intervalo de datas a ser consultado
$DATE_FROM	date (ISO 8601)	Sim	Data final do intervalo de datas a ser consultado

Você obterá uma resposta como a seguinte:

{
  "total": 174,
  "date_from": "2025-01-01T00:00:00Z",
  "date_to": "2025-04-01T17:01:00Z",
  "user_id": "127232529"
}

Interações recentes com WhatsApp por usuário

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/users/$USER_ID/contacts/whatsapp/time_window?unit=$UNIT&last=$LAST&ending=$ENDING'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor
$LAST	option	Sim	Quantidade de tempo definida em unit, por exemplo `last=2&unit=day` (últimos 2 dias).
$UNIT	integer	Sim	Unidade de tempo, por exemplo `unit=day` (padrão) ou `hour`.
$ENDING	date (ISO 8601)	Sim	Data ISO limite para a contagem. Se não for informada, a data e hora atuais serão utilizadas.

Você obterá uma resposta como a seguinte:

{
  "total": 31,
  "last": "3",
  "unit": "day",
  "date_from": "2022-10-26T04:00:00Z",
  "date_to": "2022-10-29T04:00:00Z",
  "user_id": "127232529",
  "results": [
    { "date": "2022-10-26T04:00:00Z", "total": 7 },
    { "date": "2022-10-27T04:00:00Z", "total": 16 },
    { "date": "2022-10-28T04:00:00Z", "total": 8 }
  ]
}

Redirecionamentos para WhatsApp por publicação

Da mesma forma que nos casos anteriores, você pode obter as interações com o botão de WhatsApp por publicação da seguinte maneira:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  \
'https://api.mercadolibre.com/items/$ITEM_ID/contacts/whatsapp?date_from=$DATE_FROM&date_to=$DATE_TO'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$ITEM_ID	string	Não	ID da publicação
$DATE_TO	date (ISO 8601)	Sim	Data inicial do intervalo a ser consultado
$DATE_FROM	date (ISO 8601)	Sim	Data final do intervalo a ser consultado

Obtendo uma resposta semelhante à seguinte:

{
  "total": 3,
  "date_from": "2025-02-14T17:01:00Z",
  "date_to": "2025-02-29T17:01:00Z",
  "item_id": "MLA1116194549"
}

Redirecionamentos para WhatsApp por publicação recentes

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/items/$ITEM_ID/contacts/whatsapp/time_window?unit=$UNIT&last=$LAST&ending=$ENDING'

Parâmetro	Tipo	Opcional	Descrição
$ACCESS_TOKEN	string	Não	Token de autenticação da API
$USER_ID	string	Não	ID do vendedor
$LAST	option	Sim	Quantidade de tempo definida em unit, por exemplo `last=2&unit=day` (últimos 2 dias).
$UNIT	integer	Sim	Unidade de tempo, por exemplo `unit=day` (padrão) ou `hour`.
$ENDING	date (ISO 8601)	Sim	Data ISO limite para a contagem. Se não for informada, a data e hora atuais serão utilizadas.

Opcionalmente, você pode consultar múltiplas publicações separando seus IDs por vírgula, usando o seguinte exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
'https://api.mercadolibre.com/items/contacts/whatsapp/time_window?ids=$ID1,$ID2&unit=$UNIT&last=$LAST&ending=$ENDING'

Você obterá uma resposta semelhante à seguinte:

{
  "total": 31,
  "last": "3",
  "unit": "day",
  "date_from": "2025-02-26T04:00:00Z",
  "date_to": "2025-02-29T04:00:00Z",
  "item_id": "MLA127232529",
  "results": [
    { "date": "2025-02-26T04:00:00Z", "total": 7 },
    { "date": "2025-02-27T04:00:00Z", "total": 16 },
    { "date": "2025-02-28T04:00:00Z", "total": 8 }
  ]
}

Campos de resposta

Parâmetro	Tipo	Descrição
total	Int	O número total de interações.
last	String	O número de unidades de tempo consideradas para o relatório.
unit	String	A unidade de tempo (por exemplo, "day" para dias).
date_from	String	A data de início do período do relatório.
date_to	String	A data final do período do relatório.
user_id	String	O ID do usuário.
results	Array	Lista de objetos que contêm os dados de resultados por dia.
results[n].date	String	A data específica do resultado dentro do período.
results[n].total	Int	O número total de interações associadas à data específica do resultado.

Leituras recomendadas

Leads

Atualizações de versão

Esta seção fornece informações sobre as atualizações da API, incluindo:

Histórico de alterações

Data	Versão	Descrição
08/11/2025	1.0	Publicação inicial