Consulta somente leitura dos anúncios públicos da Imobz no Panamby e em São Paulo. Não exige autenticação. Não fornece dados de clientes, reservas, propostas ou pagamentos.
Especificação OpenAPI · Instruções para agentes
Busque imóveis por bairro, condomínio, endereço ou código. Para agendamento e propostas, encaminhe a pessoa à equipe Imobz. Não há servidor MCP público.
GET https://www.imobz.com.br/api/v1/search?q=itapaiuna%201800&per_page=5&page=1
| Parâmetro | Descrição |
|---|---|
| q | Obrigatório. Termo de 1 a 200 caracteres; * lista o catálogo. |
| page | Página de 1 a 100. Padrão: 1. |
| per_page | De 1 a 20 anúncios. Padrão: 10. |
JSON com found (total), page e hits. Cada hit contém document com campos públicos do anúncio. Preços e disponibilidade podem mudar; confirme com a equipe antes de tomar uma decisão.
HTTP 400: parâmetros inválidos; 405: método inválido; 502: serviço indisponível; 504: tempo limite. Os erros retornam JSON com error.code, error.message e error.hint.
{"error":{"code":"INVALID_PARAMETERS","message":"Parâmetros de busca inválidos.","hint":"Informe q e consulte /openapi.json."}}
Use paginação, armazene resultados por pelo menos 60 segundos e evite consultas concorrentes ou coleta integral repetida. A API limita cada resposta a 20 anúncios e cada busca a 100 páginas. Em falhas, aguarde antes de repetir.
A API atual é v1, em /api/v1/search. /api/search permanece como alias compatível. Mudanças incompatíveis terão nova versão de rota. Uma eventual descontinuação será anunciada nesta documentação com pelo menos 90 dias, usando os cabeçalhos Deprecation e Sunset quando houver uma data definida. A v1 não tem descontinuação programada.
Até 200 consultas por IP a cada janela de 60 segundos, por instância do servidor. Controle de melhor esforço: novas instâncias ou reinícios possuem contadores independentes; não é uma cota global. Cada resposta informa RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset (segundos até reinício da janela). Ao atingir o limite, HTTP 429 inclui Retry-After em segundos. Use esse valor antes de repetir a consulta. X-API-Version informa a versão 1.