Brazil's VivaReal listings, with every filter, condo fee and IPTU, and the agent's contact
VivaReal (vivareal.com.br, Grupo OLX) is one of Brazil's largest property portals: 3,481,424 listings for sale on 2026-11-16.
- endpoints
- 12
- credits per call
- 1–2
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
- APARTAMENTO PINHEIROS 4 DORMITÓRIOS 2 VAGAStrue
- headline
- Apartamento com 4 Quart…
- listing_type
- used
- LIVING FULL ELDORADO - FASE 2true
- headline
- LIVING FULL ELDORADO -…
- listing_type
- new_development
- Apartamento para venda possui 100 metros quadrados com 2 quartostrue
- headline
- Cobertura com 3 Quartos…
- listing_type
- used
12 active endpoints, on 1 and 2 credit tiers.
- POST/vivareal/v1/locations1 credit
- POST/vivareal/v1/search2 credits
- POST/vivareal/v1/developments2 credits
- POST/vivareal/v1/count1 credit
- POST/vivareal/v1/listing1 credit
- POST/vivareal/v1/price_insights2 credits
- POST/vivareal/v1/agency2 credits
- POST/vivareal/v1/agency_listings2 credits
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
VivaReal (Brazil) API
5 of 12 endpoints, ready to run
Search a neighbourhood with the site's own filters
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What VivaReal (Brazil) endpoints does ReefAPI ship?
12 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a VivaReal (Brazil) endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the VivaReal (Brazil) API works
VivaReal (Brazil) is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a neighbourhood to every matching listing and the agencies behind them
Count the market, page through the matches, open each listing, then pull each agency's whole portfolio.
São Paulo&property_type=apartment&min_bedrooms=2
The site's own total for the filters, with how many matches have each amenity.
São Paulo&property_type=apartment&min_bedrooms=2&sort=newest&page=1
30 rows per page: id, price, condo fee, IPTU, area, rooms, address with coordinates, photos, amenities and the agency with phones.
Title, full description, every photo and video, nearby stations, and the advertiser's CRECI, phones and WhatsApp.
Every live listing of that agency, with the same filters.
A dated feed of matching Brazilian listings with full prices and fees and a contact for each agency.
curl -X POST https://api.reefapi.com/vivareal/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"Pinheiros, São Paulo"}'{
"ok": true,
"data": { … },
"meta": {
"api": "vivareal",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a VivaReal field actually contains
Fields that read differently from how they look. Every row was measured against live vivareal.com.br data on 2026-11-16.
| Field | What it holds |
|---|---|
| prices.sale_price_brl, rent_price_brl | The sale price ('Venda') and the monthly rent ('Aluguel') the listing page prints. A listing offered both ways carries both. On 20 listings checked against their own page on 2026-11-16, 66 of 66 price, condo-fee and IPTU values matched. |
| prices.condo_fee_brl | The monthly condominium fee ('Condomínio') as printed. Null when the listing states none. |
| prices.iptu_brl, iptu_period | The IPTU property-tax figure the page prints under 'IPTU', with the period the advertiser declared in iptu_period. |
| prices.rent_total_brl | Rent plus condominium fee, as the site computes it for rentals (3,497 rent + 150 condo fee = 3,647). |
| prices.sale_price_max_brl | For a new development with several unit prices: the highest unit price, next to the lowest in sale_price_brl ('a partir de'). The search row of a development carries the lowest price only; listing carries every unit. |
| title, description (search rows) | The results list carries no title or description for ordinary listings: 49 of 299 rows across 10 searches had them, the paid 'SUPER PREMIUM' rows and owner listings. Every row has headline (the card heading, e.g. 'Apartamento com 3 Quartos à venda, 110m²'); listing returns the title and the full description. |
| promoted | true for the paid placements the site mixes into relevance-ordered pages (2 per 30-row page on most searches). Sorting by newest returns no promoted rows. |
| below_market | true when the site shows its 'Ótimo preço' badge (priced below the market); 2,788 of 23,141 sale listings in Pinheiros, São Paulo. |
| advertiser.verified | The site's 'Anunciante verificado' badge: true on 117 of 299 search rows. Null when the advertiser record does not say. |
| advertiser.license_number | The agency's CRECI licence as published (e.g. 19828-J-SP): 138 of 299 search rows. Private owners and development aggregators publish none. |
| property_type | What the listing record itself says. The site's type filter can return rows whose record only names the broader type: a studio search for rent in São Paulo gave 13 of 30 rows marked studio, 15 marked apartment, 2 kitnet. |
| developer.listings_total, own_account_listings_total | listings_total is what the developer's own page lists (Abyara: 73). Developments are often advertised through partner accounts, so own_account_listings_total (listings under the developer's own advertiser account) is often 0. |
Prices are in Brazilian reais (BRL) as the site prints them. Of 20 listing ids taken from searches, 19 came back with the same area and bedrooms; on the 20th the search row said 40 m² while the listing and its page said 45 m².
VivaReal coverage, measured
Every number below was read from live vivareal.com.br data on 2026-11-16.
3,481,424 listings for sale across Brazil; São Paulo city 757,627 for sale; Minas Gerais state 213,906; 2,293 new developments across Brazil, 973 in São Paulo; 133 developers in the site's directory.
Of 6 searches checked against the number the site prints on its own results page, 4 matched exactly (Pinheiros for sale 23,141, Copacabana rental apartments 633, 2-bedroom ones 139, Moema 3-bedroom rentals 1,088) and 2 were 1 apart, read seconds apart (Pinheiros apartments 15,897 vs 15,898, São Paulo houses 172,391 vs 172,392).
Pinheiros, São Paulo, 23,141 for sale: apartments 15,898, with a pool 10,096, at least 120 m² 8,087, condo fee up to R$ 800 7,947, virtual tour 5,351, 'Ótimo preço' 2,788, Festival da Mudança 989, by owner 46. Pinheiros rentals 14,436: up to R$ 4,000 2,608, without guarantor 17, seasonal 10.
On 20 listings, 66 of 66 sale, rent, condo-fee and IPTU values matched the listing page's own printed prices, and 66 of 66 search-row values matched the listing; area and bedrooms 37 of 37.
Across 299 search rows in 10 categories: phone numbers 299, WhatsApp 230, CRECI licence 138, verified badge 117 (development aggregators and private owners publish no CRECI).
30 rows per page and 50 pages per search (1,500 rows), the site's own limit. Search rows of ordinary listings carry no title or description (the listing does). A condominium's listings come 5 per page, as on its page. A developer's page lists all its developments at once (up to 600 seen, a 4 MB page), and 4 of 9 developer pages checked listed none. No price history is published.
What people build with VivaReal (Brazil)
The jobs this data is most often used for.
endpoints
credits per call
Track asking prices, rents, condo fees and IPTU per neighbourhood in Brazilian cities.
Build a lead list of real-estate agencies with CRECI, phones, WhatsApp and live listing counts.
Monitor new listings in a search with sort=newest and alert on matches.
Map every development of a property developer, with prices, unit sizes and construction stage.
What VivaReal (Brazil) data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/vivareal/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"Pinheiros, São Paulo"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/vivareal/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"location": "Pinheiros, São Paulo"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up VivaReal (Brazil).
Do I need a VivaReal account?▾
No. Everything is read logged out.
Which filters can I use?▾
Price (or rent; for rentals optionally rent + condo fee), condo fee, bedrooms, bathrooms and parking spaces (exact counts or a minimum, 4 meaning 4 or more), usable and total area, 24 property types, 210 amenities, the 'Ótimo preço' badge, the running seasonal campaign, virtual tour, near metro or train, rent without guarantor, seasonal rent, owner-only, keyword and the advertiser's reference code. In Pinheiros, São Paulo, 23,141 listings were for sale on 2026-11-16: apartments 15,898, at least 3 bedrooms 6,003, up to R$ 800,000 6,858, with a pool 10,096, 'Ótimo preço' 2,788, in the Festival da Mudança campaign 989, by owner 46.
Can I search a whole state, or a map area?▾
Yes. A state name or code searches the whole state (Minas Gerais: 7,655 farms for sale; SP: 31,365 warehouses). A point with radius_km (2 km around Pinheiros: 34,703 for sale) or a box with north, south, east and west (17,049) works too, and several places can be searched together: 'Pinheiros, São Paulo | Perdizes, São Paulo' gave 41,816.
Can I paste a VivaReal search link?▾
Yes. The place, sale or rent and property type come from the link's path and the other filters from its query (quartos, precoMaximo, amenities, ordem…). The Copacabana 2-bedroom rental apartments link counted 139, the same number its page printed.
How deep can I page?▾
30 listings per page, pages 1 to 50: the site serves the first 1,500 results of any search, and asking for page 51 is refused by the site itself. total always carries the full count (757,627 listings for sale in São Paulo city), so narrow the filters or the place to reach the rest. Paging with sort=newest gave 90 different listings on pages 1 to 3.
Do I get the agent's phone number and CRECI?▾
Yes, as the advertiser publishes them: phone numbers on 299 of 299 search rows, WhatsApp on 230, the CRECI licence on 138 and the verified badge on 117. agency adds the agency's address, website, rating and how many listings it has for sale and for rent.
Does it cover new developments and the developers behind them?▾
Yes. developments returns them with construction stage (planned, under construction, ready), the developer, price-from and area and bedroom ranges; São Paulo had 973 on 2026-11-16 (77 planned, 521 under construction, 374 ready). developers lists the site's directory of 133 property developers, and developer returns one developer's profile with every development its page lists, all at once (Abyara 73).
Is there price history?▾
No. VivaReal does not publish a listing's past prices to logged-out visitors, so the API does not return any. price_insights returns the site's current averages per city or neighbourhood instead.
What is the VivaReal (Brazil) API?▾
VivaReal (Brazil) API is a ReefAPI endpoint group for brazilian homes for sale and rent on vivareal.com.br: every site filter, full listings with condo fee and iptu, the agent's creci and phones, price statistics, condominiums and property developers. It returns live JSON through POST requests under /vivareal/v1.
Is the VivaReal (Brazil) API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. VivaReal (Brazil) calls use the same shared credit balance as every other ReefAPI engine.
Do I need a VivaReal (Brazil) login or account?▾
No login to VivaReal (Brazil) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the VivaReal (Brazil) data?▾
The page example is captured from a live locations call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the VivaReal (Brazil) API use?▾
VivaReal (Brazil) actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call VivaReal (Brazil) from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call vivareal actions with the same key, credit pool and JSON envelope used by normal REST requests.
38 Real Estate APIs on the same key
One key, one credit pool, one response envelope. If you are pulling VivaReal (Brazil), you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.