Santander Imóveis API API para busca de imóveis do Santander com diversos filtros personalizáveis. ## Filtros Disponíveis ### Localização #### Estado (state) - Tipo: String - Descrição: Estado onde deseja buscar imóveis - Formato: Sigla do estado (2 letras) - Valores possíveis: AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO - Valor padrão: "SP" #### Cidade (city) - Tipo: String - Descrição: Cidade onde deseja buscar imóveis - Formato: Nome da cidade - Valor padrão: "SAO PAULO" - Exemplo: "PORTO ALEGRE" ### Características do Imóvel #### Categoria (category) - Tipo: Array de strings - Descrição: Categorias de imóveis para busca - Valores possíveis: - comercial: Imóveis comerciais - residencial: Imóveis residenciais - industrial: Imóveis industriais - rural: Imóveis rurais #### Situação (situation) - Tipo: Array de strings - Descrição: Status de ocupação do imóvel - Valores possíveis: - ocupado: Imóvel ocupado - desocupado: Imóvel vazio - locado: Imóvel alugado #### Tipo de Imóvel (type) - Tipo: Array de strings - Descrição: Tipos específicos de imóveis - Valores possíveis: - apartamento: Apartamento - galpao: Galpão - casa: Casa - loja: Loja - casacom: Casa em condomínio - salacomer: Sala Comercial - chacara: Chácara - lote: Lote - fazenda: Fazenda - lotecom: Lote em condomínio ### Preço #### Preço Máximo (maxPrice) - Tipo: Inteiro - Descrição: Valor máximo do imóvel em reais - Valor mínimo: 0 - Exemplo: 100000 (para R$ 100.000,00) #### Preço Mínimo (minPrice) - Tipo: Inteiro - Descrição: Valor mínimo do imóvel em reais - Valor mínimo: 0 - Exemplo: 50000 (para R$ 50.000,00) ### Configurações de Scraping #### Número de Páginas (numberOfPages) - Tipo: Inteiro - Descrição: Quantidade de páginas que serão extraídas - Valor padrão: 1 - Valor máximo: 1000 #### Delay entre Domínios (sameDomainDelaySecs) - Tipo: Inteiro - Descrição: Tempo de espera (em segundos) entre requisições ao mesmo domínio - Valor padrão: 1 #### Concorrência Mínima (minConcurrency) - Tipo: Inteiro - Descrição: Número mínimo de páginas para extrair simultaneamente #### Concorrência Máxima (maxConcurrency) - Tipo: Inteiro - Descrição: Número máximo de páginas para extrair simultaneamente ### Configuração de Proxy #### Proxy (proxy) - Tipo: Objeto - Descrição: Configurações de proxy para as requisições - Propriedades: - useApifyProxy: Boolean (padrão: false) - Observação: Permite definir um proxy para passar os dados através dele ## Exemplo de Uso json { "state": "RS", "city": "PORTO ALEGRE", "category": ["residencial"], "situation": ["desocupado"], "type": ["apartamento", "casa"], "minPrice": 200000, "maxPrice": 500000, "numberOfPages": 5, "sameDomainDelaySecs": 2, "minConcurrency": 1, "maxConcurrency": 3, "proxy": { "useApifyProxy": false } } Este exemplo buscará imóveis residenciais desocupados (apartamentos e casas) em Porto Alegre/RS, com valores entre R$ 200.000 e R$ 500.000, extraindo 5 páginas de resultados. ## Dados de Saída (Output) A API retorna informações detalhadas sobre cada imóvel encontrado. Abaixo está a descrição de cada campo retornado: ### Informações Básicas - url: URL completa do anúncio do imóvel - codigo: Código identificador único do imóvel (ex: "Cód. 02.20592") - titulo: Título do anúncio - endereco: Endereço completo do imóvel, incluindo CEP ### Valores e Condições - valorAvaliado: Valor de avaliação do imóvel - valorVenda: Valor de venda atual - desagio: Percentual de desconto em relação ao valor avaliado - dataLeilao: Data e hora do leilão (quando aplicável) - condominio: Valor do condomínio (quando aplicável) - iptu: Valor do IPTU ### Status e Documentação - ocupacao: Status de ocupação do imóvel - matriculas: Número da matrícula do imóvel - rgi: Registro Geral do Imóvel - inscricaoPrefeitura: Número de inscrição na prefeitura ### Áreas - areaDescription: Descrição textual das áreas - categorizedAreas: Objeto contendo áreas específicas: - areaTotal: Área total - areaTerreno: Área do terreno - areaPrivativa: Área privativa - areaUtil: Área útil - areaConstruida: Área construída - areaComum: Área comum ### Informações do Leilão - leiloeiro: Nome da empresa leiloeira - telefone: Telefone para contato - urlLeiloeiro: Link para o site do leiloeiro - condicoesPagamento: Condições disponíveis para pagamento - consideracoes: Observações importantes sobre o imóvel ### Mídia - imageUrls: Array com URLs das imagens do imóvel ## Exemplo de Output json { "url": "https://www.santanderimoveis.com.br/venda/imovel/casa-exemplo", "valorAvaliado": "R$ 1.350.000", "valorVenda": "R$ 602.640", "desagio": "55%", "codigo": "Cód. 02.20592", "titulo": "Casa na Estrada Exemplo", "endereco": "Estrada Exemplo, 123, Bairro, Cidade - UF", "ocupacao": "Ocupado", "areaDescription": "1435 m² de área terreno, 275 m² de área construída", "leiloeiro": "Exemplo Leilões", "condicoesPagamento": "À vista ou Financiamento em até 420 meses" } ## Observações Importantes - Os valores monetários são retornados no formato brasileiro (R$ X.XXX,XX) - As datas são retornadas no formato dd/mm/yyyy - As áreas são retornadas em metros quadrados (m²) - Alguns campos podem retornar null quando a informação não estiver disponível - As URLs das imagens são temporárias e podem expirar