Santander Imóveis API
Try for free
2 hours trial then $20.00/month - No credit card required now
Go to Store
Estado (
Cidade (
Categoria (
Situação (
Tipo de Imóvel (
Preço Máximo (
Preço Mínimo (
Número de Páginas (
Delay entre Domínios (
Concorrência Mínima (
Concorrência Máxima (
Proxy (
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 comerciaisresidencial
: Imóveis residenciaisindustrial
: Imóveis industriaisrural
: 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 ocupadodesocupado
: Imóvel vaziolocado
: Imóvel alugado
Tipo de Imóvel (type
)
- Tipo: Array de strings
- Descrição: Tipos específicos de imóveis
- Valores possíveis:
apartamento
: Apartamentogalpao
: Galpãocasa
: Casaloja
: Lojacasacom
: Casa em condomíniosalacomer
: Sala Comercialchacara
: Chácaralote
: Lotefazenda
: Fazendalotecom
: 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óvelcodigo
: Código identificador único do imóvel (ex: "Cód. 02.20592")titulo
: Título do anúncioendereco
: Endereço completo do imóvel, incluindo CEP
Valores e Condições
valorAvaliado
: Valor de avaliação do imóvelvalorVenda
: Valor de venda atualdesagio
: Percentual de desconto em relação ao valor avaliadodataLeilao
: 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óvelmatriculas
: Número da matrícula do imóvelrgi
: Registro Geral do ImóvelinscricaoPrefeitura
: Número de inscrição na prefeitura
Áreas
areaDescription
: Descrição textual das áreascategorizedAreas
: Objeto contendo áreas específicas:areaTotal
: Área totalareaTerreno
: Área do terrenoareaPrivativa
: Área privativaareaUtil
: Área útilareaConstruida
: Área construídaareaComum
: Área comum
Informações do Leilão
leiloeiro
: Nome da empresa leiloeiratelefone
: Telefone para contatourlLeiloeiro
: Link para o site do leiloeirocondicoesPagamento
: Condições disponíveis para pagamentoconsideracoes
: 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
Categories