REAL ESTATE · BRAZIL
VivaReal & ZAP Imóveis: Brazil Property Listings
Collect public Brazilian property listings from VivaReal and ZAP Imóveis as structured records with BRL prices, areas, room counts, location, amenities, images and source links.
About this data
Collect public Brazilian property listings from VivaReal and ZAP Imóveis as structured records with BRL prices, areas, room counts, location, amenities, images and source links.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/br/vivareal-zap/listings
Fetch one results page with up to 20 Brazilian property listings from one portal per call.
Filter by city, state, sale or rent, property type and price.
Records include titles, BRL prices, areas, bedrooms, bathrooms, parking, neighborhood, agency names, images and source URLs; fees and taxes appear when published.
No detail or contact endpoints are requested.
Input
Send a JSON body to POST https://api.ssh.autos/v1/br/vivareal-zap/listings.
| Field | Type | Required | Notes |
|---|---|---|---|
portal | string | optional | one of vivareal, zap; default "vivareal" |
city | string | optional | 1–100 characters; default "São Paulo" |
state | string | optional | 2–40 characters; default "SP" |
businessType | string | optional | one of sale, rent; default "sale" |
propertyType | string | optional | one of all, apartment, house, condominium, land, commercial; default "all" |
minPrice | number | optional | at least 0 |
maxPrice | number | optional | at least 0 |
maxResults | integer | optional | 1–20; default 10 |
Returned fields
The answer is JSON: records, a list of up to 20, and summary, the run status and counts. Each record has these 31 fields; a field the source does not publish comes back null.
31 fields per record
| Field | Type | Notes |
|---|---|---|
listingId | string | — |
portal | string | — |
businessType | string | — |
propertyType | string | — |
price | number | — |
currency | string | — |
condoFee | number | — |
iptu | number | — |
iptuPeriod | string | — |
usableAreaM2 | number | — |
totalAreaM2 | number | — |
bedrooms | number | — |
bathrooms | number | — |
suites | number | — |
parkingSpaces | number | — |
street | string | — |
neighborhood | string | — |
city | string | — |
state | string | — |
latitude | number | — |
longitude | number | — |
amenities | array of strings | — |
imageUrls | array of strings | — |
advertiserPhones | array or string or object | Published advertiser phones in source format, filled only when the source page carries them (searchUrl pages); null on the default search or when unavailable. |
advertiserEmails | array or string or object | Published advertiser emails in source format, filled only when the source page carries them (searchUrl pages); null on the default search or when unavailable. |
advertiserContact | object or array or string | Published advertiser contact information, filled only when the source page carries it (searchUrl pages); null on the default search or when unavailable. |
agencyName | string | Published advertiser name, including individual advertisers, regardless of license or contract type. |
createdAt | string | — |
updatedAt | string | — |
url | string | — |
observedAt | string | — |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/br/vivareal-zap/listings -m POST -b '{"city": "São Paulo", "state": "SP", "maxResults": 5}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: VivaReal & ZAP Imóveis Scraper: Brazil Property Listings. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt