Guia · Buscar e sincronizar imóveis
Buscar com filtros, paginar e manter a base sincronizada sem reler tudo a cada vez.
O que este guia fazComo listar imóveis com filtros, paginar e manter a sua base sincronizada sem reler tudo a cada vez.
Escopo necessário:
imoveis:read
🔎 Buscar com filtros
O filtro vai no corpo de um POST /properties/search, 20 imóveis por página (até 100 com perPage). Cada item sai no mesmo formato que o PUT aceita de volta.
curl -X POST https://api.imoviewnext.com.br/pub/v1/properties/search \
-H "Authorization: Bearer imn_seuconvenio_..." \
-H "Content-Type: application/json" \
-d '{
"transactionType": "sale",
"salePrice": { "min": 500000, "max": 900000 },
"characteristics": { "Quartos": { "min": 3 } },
"page": 1
}'🧩 Tipos de filtro
Todo campo que a resposta traz é filtrável.
| Tipo do campo | Formas de filtrar |
|---|---|
| Texto | valor exato, lista de valores, {"contains": "..."}, {"isNull": true} |
| Número | valor, lista, {"min": n, "max": n} |
| Data e hora | {"from": "...", "to": "..."}, em ISO 8601 |
Dia (campo só de data, como startDate do contrato ou dealDate do negócio) | "AAAA-MM-DD" exato ou {"from": "AAAA-MM-DD", "to": "AAAA-MM-DD"}, inclusivos e sem fuso |
| Característica | por nome, com value exato ou min/max ("três quartos ou mais") |
Campo desconhecido no filtro é400Um campo inválido devolve
400(FST_ERR_VALIDATION), nunca é ignorado em silêncio: um filtro que não filtra devolveria a base inteira e você acharia que filtrou.
🔁 As outras buscas funcionam igual
Condomínios, lançamentos, pessoas e as buscas do fluxo comercial (atendimentos, captações, atividades, visitas, propostas, negócios) e de contratos usam as mesmas formas de filtro, a mesma paginação e a mesma ordenação. Em todas, cada item volta no formato do GET /{id} daquele objeto. Os campos filtráveis de cada uma estão na descrição do endpoint.
🏗️ Unidade de lançamento
Um imóvel com launch preenchido é uma tipologia. A busca traz o imóvel avulso e uma tipologia representante por lançamento, nunca todas as unidades.
Por que só uma tipologia?Publicar todas as unidades de um lançamento é tratado como conteúdo duplicado pelos portais, e a penalização cai na conta da imobiliária. Para uma unidade específica, use
GET /properties/{id}(que não esconde tipologia).
⏱️ Sincronizar sem reler tudo
Para atualizar só o que mudou desde a última leitura, filtre por updatedAt:
{
"updatedAt": { "from": "2026-08-31T12:00:00Z" },
"sort": "updatedAt",
"order": "asc"
}Guarde o updatedAt do último item lido e use como from na próxima sincronização. Assim você processa apenas os registros novos ou alterados.
📄 Ler um imóvel específico
curl https://api.imoviewnext.com.br/pub/v1/properties/{id} \
-H "Authorization: Bearer imn_seuconvenio_..."
Leia, altere e reenvie sem traduçãoO
GET /{id}devolve o imóvel no mesmo formato doPUT, então você pode ler, alterar e reenviar sem converter nada.
Updated 20 days ago