# Viva Real Ad

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/viva-real/ad` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/viva-real-ad |

## Description

Fetch a single Viva Real Brazil property listing by URL or ID and get price, area, rooms, condo fee, IPTU, full description, agent contact, images, and geo coordinates as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/viva-real/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Apartment listing in Moema, São Paulo

```json
{
  "id": "2948312784",
  "lat": -23.6012,
  "lon": -46.6644,
  "url": "https://www.vivareal.com.br/imovel/apartamento-2-quartos-moema-bairros-sao-paulo-sp-70m2-venda-id-2948312784/",
  "city": "São Paulo",
  "iptu": 182,
  "floor": 6,
  "price": 895000,
  "state": "SP",
  "title": "Apartamento para comprar com 70 m², 2 quartos, 2 banheiros, 1 vaga em Moema, São Paulo",
  "images": [
    "https://resizedimgs.vivareal.com/fit-in/1280x720/vr.images.sp/2948312784_01.jpg",
    "https://resizedimgs.vivareal.com/fit-in/1280x720/vr.images.sp/2948312784_02.jpg",
    "https://resizedimgs.vivareal.com/fit-in/1280x720/vr.images.sp/2948312784_03.jpg"
  ],
  "street": "Rua Canário",
  "suites": 1,
  "bedrooms": 2,
  "zip_code": "04521-001",
  "amenities": [
    "Piscina",
    "Academia",
    "Salão de festas",
    "Portaria 24h",
    "Varanda"
  ],
  "bathrooms": 2,
  "condo_fee": 1680,
  "video_url": null,
  "agent_name": "Carlos Henrique Souza",
  "area_total": 70,
  "updated_at": "2026-04-27T16:45:00Z",
  "year_built": 2008,
  "agency_name": "Imobiliária Lello",
  "agent_phone": "+55 11 94321-8765",
  "area_useful": 65,
  "description": "Excelente apartamento de 70 m² no coração de Moema, bairro nobre e bem localizado de São Paulo. O imóvel possui dois dormitórios, sendo uma suíte com armários planejados, sala ampla com varanda, cozinha equipada e uma vaga de garagem.",
  "accepts_pets": false,
  "is_furnished": false,
  "neighborhood": "Moema",
  "published_at": "2026-04-10T11:00:00Z",
  "total_floors": 12,
  "price_per_sqm": 12786,
  "property_type": "Apartamento",
  "floor_plan_url": null,
  "parking_spaces": 1,
  "transaction_type": "venda",
  "is_new_development": false
}
```

## Documentation

## Overview

Viva Real applies Cloudflare bot protection on every listing page. Piloterr handles the bypass transparently. One GET request with a listing URL or ID returns the full property sheet: price, condo fee, IPTU, area, amenities, agent contact, geo coordinates, and all images.

## Quickstart

```
GET https://api.piloterr.com/v2/viva-real/ad?query=2948312784
```

## Main use cases

- Pull the full property sheet to feed a proptech comparison platform with live Viva Real data
- Extract geo coordinates and amenities for a neighborhood liveability scoring tool
- Track price and fee changes on specific listings to detect motivated sellers
- Enrich rental workflows with pets and furnishing flags before contacting tenants
- Power a Brazilian real estate pipeline feeding valuation models and investment dashboards