Viva Real Scraper

Viva Real Scrapper

This scrapper extracts real estate listings from www.vivareal.com.br, a prominent Brazilian real estate property portal. It allows you to gather comprehensive information about properties available for sale or rent directly from search results. The scraper provides a structured, easy-to-use dataset containing all the relevant property details, such as price, location, bedroom and bathroom count, amenities, and more.

How to use

1- passing location details

{
  "state": "sp",
  "municipality": "sao-paulo",
  "maxItems": 10,
  "search_type": "aluguel"
}

state

State must be one of the following: 'acre', 'alagoas', 'amapa', 'amazonas', 'bahia', 'ceara', 'espirito-santo', 'goias', 'maranhao', 'mato-grosso', 'mato-grosso-do-sul', 'minas-gerais', 'para', 'paraiba', 'parana', 'pernambuco', 'piaui', 'rj', 'rio-grande-do-norte', 'rio-grande-do-sul', 'rondonia', 'roraima', 'santa-catarina', 'sp', 'sergipe', 'tocantins', 'distrito-federal'

search_type

search_type can be either 'aluguel' or 'venda'. Default is 'aluguel'. If you want to search for new property, use the crawler passing url instead.

municipality

Municipality where you want to search for properties. Must be the name of the municipality without accent mark. Example: 'sao-paulo', 'rio-de-janeiro', etc.

2- passing URL

{
  "maxItems": 10,
  "url": "https://www.vivareal.com.br/venda/distrito-federal/brasilia/bairros/asa-sul/?transacao=venda&onde=,Distrito%20Federal,Bras%C3%ADlia,Bairros,Asa%20Sul,,,neighborhood,BR%3EDistrito%20Federal%3ENULL%3EBrasilia%3EBarrios%3EAsa%20Sul,-15.811417,-47.894501,&pagina=1&banheiros=2,3,4&quartos=3,4"
}

Sample Output JSON

{
  "id": "2807962083",
  "url": "https://www.vivareal.com.br/imovel/apartamento-3-quartos-jardim-caravelas-sao-paulo-com-garagem-84m2-aluguel-RS5400-id-2807962083/?source=ranking%2Crp",
  "title": "Apartamento na Rua Anhembi, 170, Jardim Caravelas em São Paulo, por R$ 5.400/Mês - Viva Real",
  "address": "Rua Anhembi, 170 - Jardim Caravelas, São Paulo - SP",
  "street": "Rua Anhembi",
  "city": "São Paulo - SP",
  "neigborhood": "Jardim Caravelas",
  "iptu": "R$ 274",
  "condo": "R$ 770",
  "area": "84",
  "bedrooms": "3",
  "suites": "1",
  "bathrooms": "2",
  "parking_spaces": "2",
  "amenities": [
    "14 andar",
    "Aceita animais",
    "Piscina",
    "Elevador",
    "Churrasqueira",
    "Condomínio fechado",
    "Academia",
    "Espaço gourmet",
    "Jardim",
    "Área de serviço",
    "Playground",
    "Varanda gourmet",
    "Salão de festas",
    "Bicicletário",
    "Portaria 24h",
    "Área de lazer",
    "Conexão à internet",
    "Portão eletrônico",
    "Ambientes integrados",
    "Brinquedoteca",
    "Salão de jogos",
    "Acesso para deficientes"
  ]
}