{"openapi":"3.1.0","info":{"title":"API pública do Imóveis Leilão Brasil","version":"1.1.0","description":"Imóveis retomados pela Caixa Econômica Federal à venda (leilão SFI, licitação aberta, venda direta online e venda online), normalizados. Fonte primária: lista pública da Caixa (https://venda-imoveis.caixa.gov.br); lista atual gerada em 2026-10-22. Gratuita, CORS liberado, 30 requisições por minuto por IP (120 com chave). O serviço não vende imóveis nem recebe propostas: a compra é feita pelo linkOficial.","contact":{"name":"Spartan TI","email":"admin@spartanti.com.br","url":"https://www.imoveisleilaobrasil.com.br/contato"},"termsOfService":"https://www.imoveisleilaobrasil.com.br/termos"},"servers":[{"url":"https://www.imoveisleilaobrasil.com.br"}],"externalDocs":{"description":"Documentação","url":"https://www.imoveisleilaobrasil.com.br/api"},"components":{"schemas":{"Imovel":{"type":"object","properties":{"id":{"type":"string","description":"Número do imóvel na Caixa (chave estável enquanto estiver à venda)"},"tipo":{"type":"string","description":"Tipo extraído da descrição"},"tipoSlug":{"type":"string","enum":["apartamento","casa","sobrado","terreno","predio","sala-comercial","loja","galpao","comercial","rural","outros"]},"uf":{"type":"string","description":"Sigla do estado"},"cidade":{"type":"string","description":"Município com grafia do IBGE"},"cidadeSlug":{"type":"string","description":"Slug da cidade"},"ibge":{"type":["integer","null"],"description":"Código IBGE do município"},"bairro":{"type":["string","null"]},"endereco":{"type":["string","null"]},"preco":{"type":"number","description":"Em reais. Em leilão e licitação é o mínimo; em venda direta, o preço final."},"avaliacao":{"type":"number","description":"Valor de avaliação do edital, em reais"},"desconto":{"type":"number","description":"Percentual abaixo da avaliação"},"financiamento":{"type":"boolean","description":"A lista da Caixa marca o imóvel como financiável"},"areaTotal":{"type":["number","null"],"description":"m²"},"areaPrivativa":{"type":["number","null"],"description":"m²"},"areaTerreno":{"type":["number","null"],"description":"m²"},"precoM2":{"type":["number","null"],"description":"Preço por m², em reais"},"quartos":{"type":["integer","null"]},"vagas":{"type":["integer","null"]},"modalidade":{"type":"string","description":"Leilão SFI, Licitação Aberta, Venda Direta Online ou Venda Online"},"modalidadeSlug":{"type":"string","enum":["leilao-sfi","licitacao-aberta","venda-direta-online","venda-online"]},"descricao":{"type":"string","description":"Texto da lista oficial"},"url":{"type":"string","description":"Ficha no Imóveis Leilão Brasil"},"linkOficial":{"type":"string","description":"Página oficial do imóvel (onde a compra acontece)"}}}},"securitySchemes":{"chave":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Opcional: eleva o limite para 120/min"}}},"paths":{"/api/imoveis":{"get":{"operationId":"buscarImoveis","summary":"Busca imóveis com filtros","parameters":[{"name":"uf","in":"query","description":"Sigla do estado","required":false,"schema":{"type":"string"}},{"name":"cidade","in":"query","description":"Slug da cidade (ex.: ribeirao-preto)","required":false,"schema":{"type":"string"}},{"name":"tipo","in":"query","description":"Tipo do imóvel","required":false,"schema":{"type":"string","enum":["apartamento","casa","sobrado","terreno","predio","sala-comercial","loja","galpao","comercial","rural","outros"]}},{"name":"modalidade","in":"query","description":"Modalidade de venda","required":false,"schema":{"type":"string","enum":["leilao-sfi","licitacao-aberta","venda-direta-online","venda-online"]}},{"name":"precoMin","in":"query","description":"Preço mínimo em reais","required":false,"schema":{"type":"number"}},{"name":"precoMax","in":"query","description":"Preço máximo em reais","required":false,"schema":{"type":"number"}},{"name":"quartos","in":"query","description":"Mínimo de quartos","required":false,"schema":{"type":"integer"}},{"name":"vagas","in":"query","description":"Mínimo de vagas","required":false,"schema":{"type":"integer"}},{"name":"descontoMin","in":"query","description":"Desconto mínimo (%)","required":false,"schema":{"type":"number"}},{"name":"financiamento","in":"query","description":"1 = só financiáveis","required":false,"schema":{"type":"string","enum":["1"]}},{"name":"q","in":"query","description":"Texto livre: cidade, bairro ou endereço","required":false,"schema":{"type":"string"}},{"name":"ordem","in":"query","description":"Ordenação","required":false,"schema":{"type":"string","enum":["relevancia","preco-menor","preco-maior","area-maior","m2-menor"]}},{"name":"pagina","in":"query","description":"Página (1…)","required":false,"schema":{"type":"integer","minimum":1}},{"name":"limite","in":"query","description":"Itens por página (máx. 100)","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"listaGeradaEm":{"type":"string","description":"Data da lista da Caixa (AAAA-MM-DD)"},"pagina":{"type":"integer"},"limite":{"type":"integer"},"resultados":{"type":"array","items":{"$ref":"#/components/schemas/Imovel"}}}}}}}}}},"/api/imovel/{id}":{"get":{"operationId":"consultarImovel","summary":"Ficha de um imóvel pelo número da Caixa","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{5,20}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Imovel"}}}},"404":{"description":"Não está na lista atual (provavelmente vendido)"}}}},"/api/ufs":{"get":{"operationId":"resumoPorEstado","summary":"Total, cidades, menor preço, desconto médio e financiáveis por UF","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/cidades/{uf}":{"get":{"operationId":"cidadesDoEstado","summary":"Cidades com imóveis num estado","parameters":[{"name":"uf","in":"path","required":true,"description":"Sigla do estado (sp, rj…)","schema":{"type":"string","minLength":2,"maxLength":2}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/novos":{"get":{"operationId":"imoveisNovos","summary":"Imóveis que entraram na última atualização da lista","parameters":[{"name":"uf","in":"query","description":"Sigla do estado (opcional)","required":false,"schema":{"type":"string"}},{"name":"limite","in":"query","description":"Máximo de itens (até 500)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"listaGeradaEm":{"type":"string","description":"Data da lista da Caixa (AAAA-MM-DD)"},"uf":{"type":["string","null"]},"resultados":{"type":"array","items":{"$ref":"#/components/schemas/Imovel"}}}}}}}}}},"/api/oportunidades/{uf}":{"get":{"operationId":"melhoresOportunidades","summary":"Ranking de oportunidades do estado (preço por m² contra pares da mesma cidade)","parameters":[{"name":"uf","in":"path","required":true,"description":"Sigla do estado (sp, rj…)","schema":{"type":"string","minLength":2,"maxLength":2}},{"name":"limite","in":"query","description":"Máximo de itens (até 50)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/estatisticas":{"get":{"operationId":"estatisticas","summary":"Números gerais da base e por UF","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/sugestoes":{"get":{"operationId":"sugestoes","summary":"Sugestões de cidade para autocompletar","parameters":[{"name":"q","in":"query","description":"Começo do nome","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}