# VivaReal Property Listings Scraper (x402)

> VivaReal Property Listings Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-02).

Scrapes structured Brazilian real estate listings from VivaReal by city or URL, returning property details with pay-per-call USDC micropayment via x402.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-property-listings-scraper-x402-6811a7e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2gaGpHKRUUtBQ8EAqpRJC

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-property-listings-scraper-x402-6811a7e1 -d '<json body>'
```

Example prompt: Scrape up to 200 apartment listings for sale in São Paulo from VivaReal, filtering for properties priced between 300000 and 800000 BRL.

## When to prefer this

Use this endpoint when you need structured Brazilian real estate listing data from VivaReal specifically, with price filtering and transaction type control. Prefer it over generic web scrapers because it returns typed property fields, handles VivaReal's pagination automatically, and only charges on successful non-empty results — making it cost-efficient for iterative searches.

## Known failure modes

- Empty result set if location is invalid or no listings match filters (not charged)
- Scraper blocked by VivaReal anti-bot measures returning empty results
- Invalid URL format for VivaReal city/listing URL causing a failed run
- maxItems set to 0 may trigger very long runs hitting the 500-page safety limit
- Network timeout on large result sets

## 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 items, each containing fields such as id, url, title, externalId, description, listingType, propertyType, and sourceListingType. Also includes a product identifier ('vivareal'). Failed or empty runs are not charged.

## 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-property-listings-scraper-x402-6811a7e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)