Feeds API
API REST gratuita para obter os imóveis dos clientes da Mapaprop e devolver as consultas dos interessados. Pensada para portais, agregadores e plataformas que querem somar inventário imobiliário real e atualizado.
O inventário está centrado na Argentina. Se o seu projeto opera em outros mercados, avaliamos conforme a disponibilidade.
O acordo
A Feeds API dá acesso, sem custo, ao inventário de imóveis de imobiliárias ativas na Mapaprop. A contrapartida é uma só: cada consulta que esses imóveis gerarem no seu portal volta para a Mapaprop.
É um intercâmbio, não um serviço gratuito. Sua plataforma soma inventário real e atualizado; as imobiliárias ganham exposição e leads qualificados. A devolução das consultas é obrigatória: é a condição que sustenta o acordo e o torna sustentável para ambas as partes.
As regras
- Devolução de leads (obrigatória): cada consulta que um imóvel receber na sua plataforma é entregue à Mapaprop via POST submit-question.
- Atribuição de fonte: a descrição de cada imóvel inclui a imobiliária que publica e o texto "Publicado a través de Mapaprop". Publica-se completa, sem cortar a fonte.
- Imagens sem hotlinking: as imagens devem ser baixadas e servidas do seu servidor. Antes de baixar, você deve nos informar um User-Agent identificável do seu bot (ex.
Empresa/1.2.3). Tráfego anônimo ou suspeito é bloqueado. - Token OAuth2: expira a cada 14 dias. Diante de um erro HTTP 403, sua aplicação deve renová-lo automaticamente e continuar.
Dois modos de integração
Distribuição massiva (Feeds API). Você recebe todo o inventário público disponível. Os clientes da Mapaprop não intervêm: seus imóveis são distribuídos no seu portal e nós comunicamos a eles que seu portal faz parte da rede de difusão. Simples e de alcance máximo.
Rede de Publicação (Feeds API + Network API). Criamos uma rede com a sua marca dentro da Mapaprop. Os clientes ativam a integração por escolha própria, você aprova cada conta e configura seu plano (cota de anúncios, custo, ciclo). Cada cliente escolhe quais imóveis publicar. Pensado para portais que querem escolher seus clientes —ou ser escolhidos por eles— e gerenciar uma relação direta por conta, inclusive com planos pagos.
Qual convém para você? Se o seu portal publica tudo o que está disponível, Distribuição massiva. Se quer uma relação identificável com cada imobiliária, Rede de Publicação. Indique ao aplicar.
Como aplicar
Buscamos integrações sérias e profissionais. Envie um email para dev@mapaprop.com com:
- Nome do projeto / empresa e site
- Países onde opera
- Tecnologia que usa
- Metas a médio e longo prazo
- Modo de integração que interessa: Distribuição massiva ou Rede de Publicação. Inicialmente recomendamos Distribuição massiva (apenas Feeds API).
Se preferir Rede de Publicação, conversamos em uma reunião.
Se aprovarmos a aplicação, você receberá as credenciais OAuth2 e os passos para começar.
Documentação
- Get Started — fluxo de integração passo a passo
- Getting Started (OAuth2) — autenticação e token
- Constants — significado dos valores de cada campo
Métodos: