# VivaReal Brazilian Real Estate Listings Scraper

> VivaReal Brazilian Real Estate Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-02).

Scrapes structured property listing data from VivaReal (Brazil's major real estate portal) by city name or listing URL, supporting both sale and rental transactions with optional price filtering.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/vivareal?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vivareal-brazilian-real-estate-listings-scraper-02fa6965
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F6TZNc1Xq4DuelxTKzgbQ

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-brazilian-real-estate-listings-scraper-02fa6965 -d '<json body>'
```

Example prompt: Search VivaReal for up to 200 apartments for sale in São Paulo priced between 300000 and 800000 BRL and give me the structured listing data including titles, URLs, and property types.

## When to prefer this

Choose this endpoint when you need structured, machine-readable real estate listing data from VivaReal specifically — Brazil's major property portal — without managing browser automation or scraping infrastructure yourself. Ideal for market research, price monitoring, or building property datasets focused on the Brazilian market. Best when you need to query by Brazilian city name or a direct VivaReal URL with optional price range filtering.

## Known failure modes

- Invalid or unrecognized city name returns empty result set
- VivaReal URL path mismatch causes incorrect transaction type detection
- maxItems set to 0 may result in very large responses hitting the 500-page safety limit
- Rate limiting or changes to VivaReal's site structure may cause empty or partial results
- Non-Brazilian city names or non-VivaReal URLs will not return valid data

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of property listing items, each containing fields such as id, url, title, externalId, description, listingType, propertyType, and sourceListingType. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "location": {
   "type": "string",
   "description": "Brazilian city name, such as São Paulo, or a VivaReal city sale or rental URL."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Stop after this many unique properties. Zero continues until the source ends or the 500-page safety limit."
  },
  "maxPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Optional maximum listing price in Brazilian reais."
  },
  "minPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Optional minimum listing price in Brazilian reais."
  },
  "transaction": {
   "enum": [
    "auto",
    "sale",
    "rental"
   ],
   "type": "string",
   "default": "auto",
   "description": "Use the URL sale or rental path automatically, or override it. City names default to sale."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "title": null,
    "externalId": null,
    "description": null,
    "listingType": null,
    "propertyType": null,
    "sourceListingType": null
   }
  ],
  "product": "vivareal"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vivareal-brazilian-real-estate-listings-scraper-02fa6965/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)