Ciclo de vida das publicações de Imóveis

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

Ciclo de vida das publicações de imóveis

Esta seção detalha o ciclo de vida de uma publicação de imóveis dentro da plataforma. Compreender a vigência e os estados de uma publicação é fundamental para gerenciar corretamente os anúncios por meio da API, permitindo que os integradores tenham um controle preciso sobre a visibilidade e disponibilidade dos imóveis.

Duração máxima e condições de publicação

Cada publicação de imóvel possui um tempo de vida máximo definido. Para que um item permaneça publicado e ativo, duas condições principais devem ser atendidas:

Cota ativa no pacote de publicação: A publicação deve estar associada a um pacote de anúncios com cota disponível. Quando a cota do pacote se esgota, a publicação pode ser automaticamente desativada. É importante verificar e gerenciar as cotas dos pacotes para garantir a continuidade das publicações.

Dentro do ciclo de vida esperado: Toda publicação possui um ciclo de vida predefinido, com uma data de início e uma data de término (ou um período de validade). A publicação deve permanecer dentro desse período para continuar ativa. Assim que o ciclo de vida expira, a publicação é desativada.

Essas vigências estão definidas na tabela a seguir, onde para cada site, categoria e tipo de operação são indicados os dias de validade das publicações:

Site	Tipo de imóvel	Operação	Dias
MLM	Casas	Venda	180
MLM	Apartamentos	Aluguel	90
MCO	Casas	Venda	180
MCO	Apartamentos	Aluguel	90
MLA	Casas	Venda	270
MLA	Casas	Aluguel	60
MLA	Apartamentos	Venda	270
MLA	Apartamentos	Aluguel	90
MLU	Casas	Venda	120
MLU	Apartamentos	Aluguel	90
MLV	Casas	Venda	90
MLV	Apartamentos	Aluguel	90
MLC	Casas	Venda	180
MLC	Casas	Aluguel	45
MLC	Apartamentos	Venda	180
MLC	Apartamentos	Aluguel	45
Todos os sites	Demais categorias	—	354

Parâmetros de tempo do ciclo de vida

Ao publicar seu imóvel, a resposta da API inclui parâmetros relacionados ao ciclo de vida da publicação (dependendo da categoria e do status do pacote de publicações).

Parâmetro	Tipo	Descrição
start_time	string	Data e hora em que o item foi criado.
stop_time	string	Data e hora em que o ciclo de vida do item termina, definida conforme a categoria e o tipo de operação (venda ou aluguel).
expiration_time	string	Data e hora de expiração do pacote de publicações ativo que cobre este item.

Comportamento do ciclo de vida

Quando o item atinge o momento definido em stop_time, a API encerra a publicação automaticamente. O status do item muda de active para closed com o substatus expired.
Se o pacote de publicações estiver ativo, mas o item estiver em closed com o substatus expired, isso indica que o ciclo de vida do item chegou ao fim.
Você pode consultar o valor de start_time para confirmar a duração do ciclo de vida ao validar o encerramento do item.

Exemplo: Um item do tipo Apartamento à Venda (Categoria MLA401806), criado com os seguintes parâmetros:

{
  "start_time": "2022-01-01T00:06:15.000Z",
  "stop_time": "2022-09-28T00:06:15.000Z",
  "expiration_time": "2023-02-01T00:06:15.000Z"
}

Podemos concluir o seguinte:

O item foi publicado em 1º de janeiro de 2022 (start_time).
Ele permanecerá ativo enquanto o pacote de publicações estiver vigente e dentro do ciclo de vida (270 dias para venda de apartamentos na Argentina (MLA).
Ao chegar em 28 de setembro de 2022 (stop_time), a publicação do item é finalizada e seu status muda para closed/expired.

Estados do ciclo de vida

Estado	Descrição
active	A publicação está ativa, visível e disponível para os usuários na plataforma.
paused	A publicação está pausada temporariamente e não é visível para os usuários. Pode ser reativada a qualquer momento.
closed	A publicação está encerrada e não pode ser reativada. Geralmente indica que o imóvel foi vendido ou retirado.

Leituras recomendadas

Atualizações de versão

Esta seção resume o histórico de alterações do guia/API.

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