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

{
  "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

{
  "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