VivaReal (Brazil) API

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

POST/vivareal/v1/search200
  1. APARTAMENTO PINHEIROS 4 DORMITÓRIOS 2 VAGAStrue
    headline
    Apartamento com 4 Quart…
    listing_type
    used
  2. LIVING FULL ELDORADO - FASE 2true
    headline
    LIVING FULL ELDORADO -…
    listing_type
    new_development
  3. Apartamento para venda possui 100 metros quadrados com 2 quartostrue
    headline
    Cobertura com 3 Quartos…
    listing_type
    used
Real result, captured Nov 16, 20263 of 30
Try it live

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

View docs ↗

Search a neighbourhood with the site's own filters

2 credits1 required · 4 optional
POST/vivareal/v1/search
idle
// 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.

Try every endpoint in the playground

Endpoints

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.

12 endpoints

locations

1 cr

Look up Brazilian places by name and get the location ids the search actions accept.

required
query
optional
type, limit

search

2 cr

Search VivaReal listings for sale or rent in a place (or around a point / inside a map box) w…

required
—
optional
location, latitude, longitude, radius_km, north, south, east, west, business, sort, page, property_type, bedrooms, min_bedrooms, bathrooms, min_bathrooms, parking_spaces, min_parking_spaces, price_min, price_max, condo_fee_min, condo_fee_max, area_min, area_max, total_area_min, total_area_max, amenities, below_market, seasonal_campaign, virtual_tour, near_transit, keyword, external_id, price_includes_fees, no_guarantor, seasonal_rental, owner_only

developments

2 cr

New developments (lançamentos) for sale.

required
—
optional
location, latitude, longitude, radius_km, north, south, east, west, sort, page, property_type, bedrooms, min_bedrooms, bathrooms, min_bathrooms, parking_spaces, min_parking_spaces, price_min, price_max, condo_fee_min, condo_fee_max, area_min, area_max, total_area_min, total_area_max, amenities, below_market, seasonal_campaign, virtual_tour, near_transit, keyword, external_id, construction_status

count

1 cr

Count the listings that match a place and filters (without fetching them), with the number of…

required
—
optional
location, latitude, longitude, radius_km, north, south, east, west, business, listing_type, property_type, bedrooms, min_bedrooms, bathrooms, min_bathrooms, parking_spaces, min_parking_spaces, price_min, price_max, condo_fee_min, condo_fee_max, area_min, area_max, total_area_min, total_area_max, amenities, below_market, seasonal_campaign, virtual_tour, near_transit, keyword, external_id, price_includes_fees, no_guarantor, seasonal_rental, owner_only, construction_status

listing

1 cr

Everything VivaReal publishes about one listing.

required
listing
optional
—

price_insights

2 cr

The site's own price statistics for a city or neighbourhood.

required
location
optional
business, property_type

agency

2 cr

A real-estate agency / advertiser profile.

required
agency
optional
—

agency_listings

2 cr

Every live listing of one agency / advertiser, for sale or for rent, with the same filters an…

required
agency
optional
business, listing_type, location, sort, page, property_type, bedrooms, min_bedrooms, bathrooms, min_bathrooms, parking_spaces, min_parking_spaces, price_min, price_max, condo_fee_min, condo_fee_max, area_min, area_max, total_area_min, total_area_max, amenities, below_market, seasonal_campaign, virtual_tour, near_transit, keyword, external_id, price_includes_fees, no_guarantor, seasonal_rental, owner_only

condominiums

1 cr

Find condominium buildings (condomínios) by name and get the id the condominium action accepts.

required
query
optional
limit

condominium

2 cr

One condominium building as its VivaReal page shows it.

required
condominium
optional
business, page

developers

1 cr

VivaReal's directory of property developers (incorporadoras / construtoras) that advertise ne…

required
—
optional
page

developer

2 cr

One property developer (incorporadora) as its VivaReal page shows it.

required
developer
optional
—

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 it works

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.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /vivareal/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01count?location=Pinheiros,
GET/vivareal/v1/count?location=Pinheiros,
São Paulo&property_type=apartment&min_bedrooms=2

The site's own total for the filters, with how many matches have each amenity.

02search?location=Pinheiros,
GET/vivareal/v1/search?location=Pinheiros,
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.

03listing?listing=<id>
GET/vivareal/v1/listing?listing=<id>

Title, full description, every photo and video, nearby stations, and the advertiser's CRECI, phones and WhatsApp.

04agency_listings?agency=<advertiser.id>
GET/vivareal/v1/agency_listings?agency=<advertiser.id>

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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "vivareal",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
prices.sale_price_brl, rent_price_brlThe 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_brlThe monthly condominium fee ('Condomínio') as printed. Null when the listing states none.
prices.iptu_brl, iptu_periodThe IPTU property-tax figure the page prints under 'IPTU', with the period the advertiser declared in iptu_period.
prices.rent_total_brlRent plus condominium fee, as the site computes it for rentals (3,497 rent + 150 condo fee = 3,647).
prices.sale_price_max_brlFor 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.
promotedtrue 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_markettrue 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.verifiedThe site's 'Anunciante verificado' badge: true on 117 of 299 search rows. Null when the advertiser record does not say.
advertiser.license_numberThe agency's CRECI licence as published (e.g. 19828-J-SP): 138 of 299 search rows. Private owners and development aggregators publish none.
property_typeWhat 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_totallistings_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².

Coverage

VivaReal coverage, measured

Every number below was read from live vivareal.com.br data on 2026-11-16.

Size

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.

Totals match the site

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).

Filters that bite

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.

Price accuracy

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.

Agent contact

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).

Limits

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.

Use cases

What people build with VivaReal (Brazil)

The jobs this data is most often used for.

12

endpoints

1/2

credits per call

01

Track asking prices, rents, condo fees and IPTU per neighbourhood in Brazilian cities.

02

Build a lead list of real-estate agencies with CRECI, phones, WhatsApp and live listing counts.

03

Monitor new listings in a search with sort=newest and alert on matches.

04

Map every development of a property developer, with prices, unit sizes and construction stage.

Pricing

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.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Same key

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.

Already paying for something else?VivaReal (Brazil) vs Bright Data
Contact

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.

0/4000

No account needed · we reply from [email protected]

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.