VivaReal Imóveis Scraper

Extract Brazilian real-estate listings from VivaReal (Grupo OLX / ZAP) as clean, structured JSON — by city, by filters, or by pasting a VivaReal search URL. Built for lead generation, market intelligence, price monitoring, and analytics pipelines.

No browser. No login. No cookies. Public data only.

Why this one

• Richest fields in the niche — price, condo fee (condomínio), yearly IPTU, the full address with latitude/longitude, property type, bedrooms, bathrooms, suites, parking spaces, usable & total area, the complete amenity list (raw codes and human-readable PT-BR labels), description, all image URLs, the advertiser (name, license/CRECI, phones), and publish/update dates.
• Three ways to ask — a simple City (+ optional State), structured filters, or just paste the VivaReal results URL you already built on the site.
• Reliable — talks to VivaReal's own JSON backend over an anti-blocking proxy that clears the Cloudflare challenge server-side; every request retries with a fresh session and falls back automatically if it gets challenged.
• Cheap — plain HTTP (no headless browser), small JSON pages.

Input

Field	Type	Notes
searchUrls	string[]	VivaReal results URLs (paginated) and/or single-property URLs (…/imovel/…-id-123/). Filters are read from the URL.
city	string	City to search when no URL is given, e.g. São Paulo. A neighborhood works too (Jardins, São Paulo).
state	string	Optional, to disambiguate the city (SP, Minas Gerais, …).
transactionType	enum	sale (venda) or rent (aluguel). Default sale.
propertyType	enum[]	apartment, house, condo, land, commercial, farm. Empty = all.
listingType	enum	used (resale) or development (lançamento).
priceMin / priceMax	integer	Price range in R$ (sale price or monthly rent).
minBedrooms	integer	Minimum bedrooms.
maxItems	integer	Max properties to return (default 100).
imageWidth / imageHeight	integer	Pixel size of the resolved image URLs (default 870×653).
proxyConfiguration	object	Advanced. Defaults to Apify Proxy UNBLOCKER.

Provide either searchUrls or city. Both can be combined.

Example

{
  "city": "São Paulo",
  "transactionType": "sale",
  "propertyType": ["apartment"],
  "priceMin": 400000,
  "priceMax": 900000,
  "minBedrooms": 2,
  "maxItems": 200
}

Output

One item per property:

{
  "type": "property",
  "id": "2878742279",
  "url": "https://www.vivareal.com.br/imovel/id-2878742279/",
  "title": "Apartamento com 2 quartos à venda...",
  "description": "...",
  "businessType": "SALE",
  "transactionType": "sale",
  "listingType": "USED",
  "propertyType": "apartment",
  "unitTypes": ["APARTMENT"],
  "price": 685000,
  "currency": "BRL",
  "condoFee": 650,
  "iptu": 2400,
  "rentPeriod": null,
  "rentTotalPrice": null,
  "area": 83,
  "usableAreas": [83],
  "bedrooms": 2,
  "bathrooms": 2,
  "suites": 1,
  "parkingSpaces": 1,
  "amenities": ["POOL", "BARBECUE_GRILL", "ELEVATOR"],
  "amenitiesLabeled": ["Piscina", "Churrasqueira", "Elevador"],
  "address": {
    "street": "Rua ...", "streetNumber": "590", "neighborhood": "Vila Dom Pedro I",
    "zone": "Zona Sul", "city": "São Paulo", "state": "São Paulo",
    "stateAcronym": "SP", "zipCode": "04276000", "country": "BR"
  },
  "latitude": -23.59887,
  "longitude": -46.613918,
  "images": ["https://resizedimgs.vivareal.com/.../imovel.jpg?action=fit-in&dimension=870x653"],
  "imagesCount": 12,
  "advertiser": {
    "id": "0b6e...", "name": "Imobiliária X", "licenseNumber": "CRECI 12345",
    "phone": "1135786452", "mobile": "11953284350"
  },
  "publishedAt": "2024-01-05T04:59:32.546+00:00",
  "updatedAt": "2024-09-...",
  "scrapedAt": "2026-10-05T...Z"
}

For rentals, price is the monthly rent and rentTotalPrice includes condo fee + IPTU when VivaReal provides it.

How it works

VivaReal serves its listing data from a JSON backend (glue-api.vivareal.com). The actor resolves your location through VivaReal's own location autocomplete, then pages that backend (24 listings per page) over Apify Proxy's UNBLOCKER group, which solves VivaReal's Cloudflare anti-bot challenge on the proxy side and returns clean JSON over a plain HTTPS GET — no headless browser and no captcha-solving key. Single-property URLs are fetched as rendered HTML (also via UNBLOCKER) and parsed from the page's embedded structured data.

Notes & limits

• VivaReal exposes up to ~10,000 results per individual search. To pull a larger market, split by neighborhood, price band, or property type.
• Only public listing data is returned. The actor never logs in and never uses cookies.