VivaReal & ZAP Imóveis Scraper

VivaReal and Zap Imóveis Scraper: Brazilian property listings with price, fees and area

Name a Brazilian city or neighbourhood and get one row per listing: the asking price, the condo fee, the IPTU, usable and total area, bedrooms, bathrooms, suites, parking, the address down to the postcode, amenities, who is advertising it, their phone and WhatsApp, and every photo.

The two portals run on one shared listing index, so both return the same properties. Choosing between them only sets which site the url points at, and the order results come back in.

🏠 What this scraper does

Write the place the way it is written in Brazil: "Pinheiros, São Paulo", "Copacabana, Rio de Janeiro", "Curitiba", "Balneário Camboriú". The portal's own place lookup decides the match, and the run log tells you which one it picked, along with the exact location id it resolved to.

Keep that id for repeat runs. It looks like BR>Sao Paulo>NULL>Sao Paulo>Zona Oeste>Pinheiros, and putting it in Portal location ids skips the lookup and guarantees the same area every time. Place names drift, ids do not.

Sale or rental, resale or new development. Rental rows also carry the monthly total with the condo fee and IPTU added on. New developments (lançamentos) are a far smaller pool, a few thousand nationally rather than millions.

One search reaches 1,500 listings. The portal stops paging there whatever its own count says. The log tells you when a search hit that wall, and splitting by neighbourhood or price band is how you get past it.

📥 What you give it

{
  "location": "Pinheiros, São Paulo",
  "portal": "vivareal",
  "business": "SALE",
  "listingType": "USED",
  "unitTypes": ["APARTMENT"],
  "bedroomsMin": 2,
  "priceMax": 1500000,
  "maxItems": 200
}

📤 What you get back

A real row from a recent run, with the description and the photo list cut short:

{
  "listingId": "2814207417",
  "portal": "VivaReal",
  "url": "https://www.vivareal.com.br/imovel/apartamento-2-quartos-pinheiros-zona-oeste-sao-paulo-com-garagem-85m2-venda-RS2650000-id-2814207417/",
  "title": "Apartamento com 2 quartos à venda e para alugar em Pinheiros, São Paulo",
  "description": "Unidade disponível em um dos empreendimentos mais sofisticados de São Paulo...",
  "businessType": "SALE",
  "listingType": "USED",
  "propertyType": "UNIT",
  "unitTypes": ["APARTMENT"],
  "usageTypes": ["RESIDENTIAL"],
  "currency": "BRL",
  "price": 2650000,
  "rentalTotalPrice": null,
  "rentalPeriod": null,
  "condoFee": 2060,
  "iptu": null,
  "iptuPeriod": "YEARLY",
  "usableArea": 85,
  "totalArea": 85,
  "bedrooms": 2,
  "bathrooms": 2,
  "suites": 2,
  "parkingSpaces": 2,
  "unitFloor": null,
  "amenities": [],
  "street": null,
  "streetNumber": null,
  "neighborhood": "Pinheiros",
  "zone": "Zona Oeste",
  "city": "São Paulo",
  "state": "São Paulo",
  "stateAcronym": "SP",
  "zipCode": "05414020",
  "fullAddress": "Rua Francisco Leitão Pinheiros  São Paulo SP",
  "latitude": null,
  "longitude": null,
  "advertiserType": "agency",
  "advertiserName": "Cobens Negócios De Bens Móveis E Imóveis Ltda",
  "advertiserId": "cef4b87e-6256-8bb2-b798-cf23e10cd883",
  "advertiserLicense": null,
  "advertiserTier": "diamond",
  "phones": ["11944822247"],
  "whatsapp": "11944822247",
  "publicationType": "STANDARD",
  "status": "ACTIVE",
  "imageUrl": "https://resizedimgs.vivareal.com/img/vr-listing/439a18da.../imovel.jpg?action=fit-in&dimension=870x653",
  "imageCount": 30,
  "images": ["https://resizedimgs.vivareal.com/img/vr-listing/439a18da.../imovel.jpg?...", "..."],
  "createdAt": "2025-06-14T19:02:35.799Z",
  "updatedAt": "2026-08-22T05:00:44.261Z",
  "searchLocation": "Pinheiros, São Paulo, São Paulo",
  "position": 1,
  "scrapedAt": "2026-09-20T02:35:14.803Z"
}

🧾 Reading the output

Run it with no location, no id and no URL and you get the one sample row. Every diagnostic carries a message and a hint next to its code.

One bad search never stops the others, and a diagnostic row never fails the run.

▶️ How to run it

1. Open VivaReal and Zap Imóveis Scraper and click Try for free. 2. Type a city or neighbourhood into Where to search. 3. Pick For sale or to rent, then add filters like Bedrooms, at least or Price up to. 4. Set Maximum listings, then click Start. 5. Download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$1.40 per 1,000 listings. Flat on every Apify plan, no volume tiers.

You pay per listing row delivered. Diagnostic rows, a place the portal cannot find, a search that matches nothing, a listing that has left the index, and the sample row are all free.

💡 What people use it for

• Tracking asking prices in a neighbourhood week by week and diffing on listingId.
• Working out the real monthly cost of a rental, since rentalTotalPrice already has the condo fee

and IPTU in it.

• Building a price-per-square-metre picture from price and usableArea across a city.
• Watching new-build launches by switching Resale or new development to DEVELOPMENT.
• Seeing which agencies hold the stock in an area, from advertiserName and advertiserTier.

🚧 What it does not do

• 1,500 listings per search. The portal stops paging there. Split by neighbourhood or price band

to go deeper.

• No sold prices and no history. Live listings only, and price is what is being asked today.
• Exact addresses and coordinates are often missing, because the advertiser chose not to publish

them.

• The two portals share one index, so running both does not get you more properties.
• Amenities come from the advertiser, so two identical flats can list different ones.
• Department-style browse pages are not the input. Use a place name, a place id, a search page

with onde=, or a listing page ending -id-<number>/.

• Brazil only, in Portuguese and in reais.

🧭 Which property scraper do you need?

❓ Questions people ask

Do I need an account on either portal? No. No login, no API key.

Which portal should I choose? Whichever link you would rather click. The properties are the same; only the url and the ordering change.

How do I make repeat runs hit exactly the same area? Run it once, copy the location id out of the run log, and put it into Portal location ids from then on.

Why is the address incomplete? Because the advertiser left it that way. Many listings publish the neighbourhood and the street but not the number, and some publish no coordinates at all.

How do I get more than 1,500 from one city? Split it. Run each neighbourhood, or the same neighbourhood in price bands.

Is scraping these portals legal? These are public listing pages, but the rows carry advertiser names, phone numbers and WhatsApp numbers, which is personal data under Brazil's LGPD and under GDPR if you are in Europe. Have a lawful reason before you collect or contact, and read each portal's terms. Apify's write-up on scraping and the law is a starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the run ID and the location or URL you used. The errorCode on the diagnostic row usually names the problem on its own.