Para portais, proptechs, CRMs e equipas de IA: lance pesquisa imobiliária e agentes de IA sem construir um pipeline de dados
As equipas de engenharia e produto podem lançar pesquisa imobiliária desduplicada e assistentes de IA em poucos dias integrando a API REST e os servidores MCP da CASAFARI. Em vez de construir e manter pipelines complexos de recolha de dados para agregar anúncios dispersos, a sua aplicação acede diretamente a um grafo de propriedades com registos únicos, histórico completo de preços de oferta e inteligência geográfica.
Como lançar pesquisa de imóveis desduplicada na sua aplicação ou CRM sem construir um pipeline?
A sua equipa disponibiliza aos utilizadores uma experiência de pesquisa limpa e sem duplicados em escassos dias, eliminando o esforço contínuo de manutenção de scrapers e regras de limpeza.
Em Portugal, onde o portal Idealista liderava o tráfego em setembro de 2026 com cerca de 6,47 milhões de visitas mensais segundo a Semrush Portugal, seguido pelo Imovirtual (~1,39 milhões) e Supercasa (~501,7 mil), a publicação simultânea de carteiras de imóveis gera múltiplos anúncios repetidos para a mesma propriedade, frequentemente com áreas e moradas divergentes.
A integração da plataforma de integração de dados e APIs da CASAFARI e do motor de Pesquisa de Propriedades (Property Sourcing) resolve este desafio. Com chamadas estruturadas por localização, polígono ou características (POST /api/v2/properties/search) ou pesquisas descritivas em linguagem natural (POST /v1/property-sourcing/searches/describe), a sua aplicação consome diretamente um registo desduplicado por imóvel. Para aprofundar a implementação, consulte o guia técnico para integrar a pesquisa de imóveis na sua aplicação (em inglês).
Como converter um link de portal ou ID de anúncio num único imóvel com todo o histórico de preços?
O seu CRM ou portal obtém instantaneamente a ficha consolidada de um imóvel a partir de qualquer URL de portal encaminhado por um comprador ou de um identificador de anúncio.
A operação POST /v1/property-sourcing/properties/resolve (que consome 25 tokens) traduz um URL colado pelo utilizador ou uma referência de agência num identificador único de propriedade (prop_...). Para cruzamentos em lote na base de dados, pode consultar a documentação sobre como agrupar anúncios dispersos num único imóvel com match-by-listings (em inglês).
Com o identificador único obtido, o endpoint GET /v1/property-sourcing/properties/{property_id}?expand=listings,history (10 tokens) devolve todas as agências comercializadoras, a amplitude dos preços de oferta atuais (valor mínimo e máximo) e a linha cronológica de alterações de valor pedido e de estado do imóvel (ativo, reservado, vendido ou retirado). Para mais detalhes, veja o caso de uso para resolver links encaminhados por clientes (em inglês).
Como fundamentar um assistente de IA ou agente MCP em dados imobiliários reais sem alucinações?
O seu assistente de IA ou copiloto responde aos utilizadores com propriedades reais verificadas no mercado, eliminando alucinações de preços de oferta ou localizações inexistentes.
Através do Casafari MCP para agentes de IA, pode ligar o Claude, ChatGPT, Cursor ou Gemini CLI diretamente aos servidores MCP via autenticação OAuth 2.1 com access tokens. Em alternativa, os ficheiros de contrato /openapi.json, tools.json e /llms.txt disponíveis em platform.casafari.com/v1/<product>/ permitem expor as ferramentas REST ao seu modelo de linguagem sem necessidade de instalar SDKs.
A arquitetura trata a gestão de erros de forma nativa sob o padrão RFC 9457 problem+json, devolvendo o código HTTP 402 quando o saldo de tokens se esgota e HTTP 429 perante limites de pedidos. Saiba mais na arquitetura de uma ferramenta imobiliária fundamentada para assistentes de IA (em inglês).
Como incorporar a pesquisa Claro AI e resolver freguesias e códigos postais com o Location Lookup?
Os seus utilizadores encontram imóveis exatamente na localização pretendida, contornando as falhas habituais de sobreposição geográfica entre códigos postais e divisões administrativas.
Como as zonas de código postal dos CTT (formatos CP4 e CP7) seguem rotas de distribuição postal e não coincidem estritamente com os limites de freguesia e concelho, o Location Lookup traduz qualquer texto livre ou código postal nos location_ids oficiais da CASAFARI através de GET /v1/locations/search. Se pretender aprofundar este tema, veja como converter nomes de locais em location_ids com o Location Lookup.
Para imobiliário comercial, pode também incorporar uma caixa de pesquisa conversacional pronta a usar ao carregar o script /embed.js e efetuar chamadas a POST /v1/embed/search utilizando uma chave publicável (prefixo pub_) restrita a domínios autorizados, obtendo até 50 resultados por página. Consulte as instruções para incorporar a caixa de pesquisa Claro AI com chave publicável (em inglês).
Como começar na plataforma self-serve com 1.000 tokens gratuitos?
A sua equipa de engenharia pode testar os endpoints e construir os primeiros protótipos em poucos minutos, sem qualquer investimento inicial.
O processo de integração é totalmente autónomo. Basta iniciar sessão na plataforma CASAFARI e ativar os 1.000 tokens gratuitos válidos por 30 dias, sem necessidade de introduzir um cartão de crédito. Quando a aplicação passar a produção, o plano Agent está disponível a partir de 70 € por mês (ou 49 € por mês com faturação anual).
Na consola de gestão, pode gerar a sua chave de API secreta (cf_sk_) para chamadas do lado do servidor ou configurar o acesso via MCP. Para informação técnica adicional, consulte o guia de ligação à plataforma via API REST e servidores MCP (em inglês) e descubra outros casos de uso da API REST da CASAFARI.
Perguntas frequentes
A CASAFARI disponibiliza um SDK em npm ou PyPI para integrar a API?
Não, a CASAFARI não disponibiliza SDKs em npm ou PyPI. A plataforma disponibiliza uma superfície de contrato OpenAPI puro por produto em platform.casafari.com/v1/
Como é que a API evita anúncios duplicados entre portais como o Idealista, Imovirtual e Supercasa?
O grafo de propriedades da CASAFARI processa e limpa continuamente os anúncios publicados por agências e portais imobiliários, agrupando todas as publicações referentes ao mesmo imóvel sob um identificador único de propriedade. Ao efetuar pesquisas através da API de Property Sourcing ou ao utilizar os endpoints match-by-listings e resolve, a sua aplicação recebe um registo desduplicado. Esse registo inclui a lista de anúncios ativos em cada portal e o histórico consolidado dos preços de oferta.
Como funciona o consumo de tokens nas chamadas à API REST e ao Casafari MCP?
Cada chamada à API REST ou ferramenta executada via Casafari MCP consome um valor fixo de tokens da sua conta, distintos dos access tokens utilizados na autenticação OAuth 2.1. Por exemplo, converter um URL de portal com a operação POST /v1/property-sourcing/properties/resolve consome 25 tokens, enquanto consultar o detalhe e histórico com GET /v1/property-sourcing/properties/{property_id} consome 10 tokens. Caso o saldo de tokens se esgote, a API devolve um erro HTTP 402 devidamente estruturado segundo a especificação RFC 9457 problem+json.
O Location Lookup resolve a diferença entre códigos postais dos CTT e freguesias em Portugal?
Sim, o Location Lookup resolve essa divergência de forma automática. Dado que as zonas de código postal dos CTT (formatos CP4 e CP7) seguem critérios de distribuição postal e não coincidem com os limites administrativos das freguesias e concelhos, o endpoint GET /v1/locations/search converte pesquisas em texto livre ou códigos postais nos location_ids oficiais. Estes identificadores garantem que as pesquisas efetuadas na sua aplicação correspondem exatamente às delimitações geográficas do motor da CASAFARI.
Que países estão cobertos pelo grafo de propriedades da CASAFARI?
O grafo de propriedades da CASAFARI cobre 16 países: Portugal, Espanha, França, Itália, Alemanha, Áustria, Suíça, Bélgica, Luxemburgo, Polónia, Grécia, Andorra, Mónaco, São Marinho e os Emirados Árabes Unidos. Adicionalmente, a CASAFARI está a entrar agora nos Estados Unidos, em estados selecionados e apenas para imobiliário comercial, através do Claro AI.
Experimente no seu próprio mercado
1.000 tokens gratuitos durante 30 dias, sem cartão. Depois, o plano Agent ou tokens pré-pagos.