Santander Imóveis API avatar

Santander Imóveis API

Try for free

2 hours trial then $20.00/month - No credit card required now

Go to Store
Santander Imóveis API

Santander Imóveis API

brasil-scrapers/santander-imoveis-api
Try for free

2 hours trial then $20.00/month - No credit card required now

API para busca de imóveis do Santander com diversos filtros personalizáveis.

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

1{
2  "state": "RS",
3  "city": "PORTO ALEGRE",
4  "category": ["residencial"],
5  "situation": ["desocupado"],
6  "type": ["apartamento", "casa"],
7  "minPrice": 200000,
8  "maxPrice": 500000,
9  "numberOfPages": 5,
10  "sameDomainDelaySecs": 2,
11  "minConcurrency": 1,
12  "maxConcurrency": 3,
13  "proxy": {
14    "useApifyProxy": false
15  }
16}

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

1{
2  "url": "https://www.santanderimoveis.com.br/venda/imovel/casa-exemplo",
3  "valorAvaliado": "R$ 1.350.000",
4  "valorVenda": "R$ 602.640",
5  "desagio": "55%",
6  "codigo": "Cód. 02.20592",
7  "titulo": "Casa na Estrada Exemplo",
8  "endereco": "Estrada Exemplo, 123, Bairro, Cidade - UF",
9  "ocupacao": "Ocupado",
10  "areaDescription": "1435 m² de área terreno, 275 m² de área construída",
11  "leiloeiro": "Exemplo Leilões",
12  "condicoesPagamento": "À vista ou Financiamento em até 420 meses"
13}

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
Developer
Maintained by Community

Actor Metrics

  • 1 monthly user

  • 1 star

  • >99% runs succeeded

  • Created in Nov 2024

  • Modified 13 days ago