# VivaReal/ZAP Brazil Property Listings Search

> VivaReal/ZAP Brazil Property Listings Search is a paid API for AI agents from api.ssh.autos, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-14).

Fetches real estate listings from VivaReal or ZAP portals in Brazil, filtered by city, state, property type, business type, and price range.

## Facts

- Endpoint: POST https://api.ssh.autos/v1/br/vivareal-zap/listings?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vivareal-zap-brazil-property-listings-search-bce4179d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PtWxmh4R_tIXDA_lLFjzC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vivareal-zap-brazil-property-listings-search-bce4179d -d '<json body>'
```

Example prompt: Search VivaReal for apartments for sale in São Paulo, SP — show me up to 10 results with a max price of 800000.

## When to prefer this

Use this endpoint when you need current Brazilian real estate listings from VivaReal or ZAP — the two dominant property portals in Brazil. Prefer this over generic web scraping when you need structured, filtered results by city, state, property type, and price. It is especially suited for agents helping users research property markets in Brazilian cities without requiring a user account on those portals.

## Known failure modes

- Empty results (status: succeeded_empty) when no listings match filters
- Invalid city or state values returning no results
- Portal enum value outside 'vivareal' or 'zap' causing validation error
- Price filters too restrictive yielding zero matches
- maxResults exceeding 20 causing schema validation failure
- Network or scraping errors from upstream portal changes

## How this service works

Live web and public-record data: marketplaces, real estate, social media, job listings, company registries and government tenders. Pay per call in USDC over x402 with no account, subscribe on the Apify Store, or buy a finished, sourced report.

## Output

Returns a JSON object with a 'records' array of property listings and a 'summary' object showing status and record count. Each record contains listing details scraped from the specified portal (VivaReal or ZAP) for the given city, state, and filters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "title": "City",
   "default": "São Paulo",
   "maxLength": 100,
   "minLength": 1
  },
  "state": {
   "type": "string",
   "title": "State",
   "default": "SP",
   "maxLength": 40,
   "minLength": 2
  },
  "portal": {
   "enum": [
    "vivareal",
    "zap"
   ],
   "type": "string",
   "title": "Portal",
   "default": "vivareal"
  },
  "maxPrice": {
   "anyOf": [
    {
     "type": "number",
     "minimum": 0
    },
    {
     "type": "null"
    }
   ],
   "title": "Maxprice",
   "default": null
  },
  "minPrice": {
   "anyOf": [
    {
     "type": "number",
     "minimum": 0
    },
    {
     "type": "null"
    }
   ],
   "title": "Minprice",
   "default": null
  },
  "maxResults": {
   "type": "integer",
   "title": "Maxresults",
   "default": 10,
   "maximum": 20,
   "minimum": 1
  },
  "businessType": {
   "enum": [
    "sale",
    "rent"
   ],
   "type": "string",
   "title": "Businesstype",
   "default": "sale"
  },
  "propertyType": {
   "enum": [
    "all",
    "apartment",
    "house",
    "condominium",
    "land",
    "commercial"
   ],
   "type": "string",
   "title": "Propertytype",
   "default": "all"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "records": [],
  "summary": {
   "status": "succeeded_empty",
   "records": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vivareal-zap-brazil-property-listings-search-bce4179d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ssh.autos](https://www.zero.xyz/host/api.ssh.autos/llms.txt)
