# Vivanuncios Ad

## Overview

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

## Description

Retrieve a full Vivanuncios property listing by URL: price, area, amenities, images, and contact details as structured JSON in real time.

## 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/vivanuncios/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup apartment in Polanco, CDMX

```json
{
  "id": "vv-48291037",
  "url": "https://www.vivanuncios.com.mx/a-venta-de-propiedades/polanco/departamento-en-venta-polanco-v-seccion-3-recamaras-148m2/xxxx/48291037",
  "area": {
    "lot_m2": null,
    "construction_m2": 148
  },
  "price": {
    "amount": 7650000,
    "currency": "MXN",
    "price_per_m2": 51689,
    "maintenance_fee": 3900
  },
  "title": "Departamento en venta en Polanco V Sección, 3 recámaras",
  "images": [
    "https://img.vivanuncios.com.mx/photos/48291037/1/1024x768.jpg",
    "https://img.vivanuncios.com.mx/photos/48291037/2/1024x768.jpg",
    "https://img.vivanuncios.com.mx/photos/48291037/3/1024x768.jpg",
    "https://img.vivanuncios.com.mx/photos/48291037/4/1024x768.jpg"
  ],
  "status": "active",
  "features": {
    "floor": "12",
    "parking": 2,
    "bedrooms": 3,
    "bathrooms": 2,
    "condition": "Excelente",
    "year_built": 2019,
    "half_bathrooms": 1
  },
  "location": {
    "state": "Ciudad de México",
    "latitude": 19.4328,
    "longitude": -99.1908,
    "full_address": null,
    "municipality": "Miguel Hidalgo",
    "neighborhood": "Polanco V Sección"
  },
  "amenities": [
    "Roof garden",
    "Alberca",
    "Gimnasio",
    "Seguridad 24 hrs",
    "Circuito cerrado",
    "Salón de eventos",
    "Bodega",
    "Lobby con concierge"
  ],
  "operation": "sale",
  "publisher": {
    "name": "Coldwell Banker México",
    "type": "agency",
    "phone": "+52 55 5280 4949",
    "logo_url": "https://img.vivanuncios.com.mx/agencies/coldwell-banker-mx/logo.jpg"
  },
  "thumbnail": "https://img.vivanuncios.com.mx/photos/48291037/1/320x240.jpg",
  "video_url": null,
  "updated_at": "2026-05-03T11:00:00.000Z",
  "description": "Amplio departamento en el corazón de Polanco V Sección, piso 12 con vistas a Paseo de la Reforma. Sala-comedor de doble altura, cocina integral equipada con isla central, 3 recámaras (master en suite con walk-in closet), 2.5 baños, cuarto de servicio. Edificio con amenidades de primer nivel. Incluye 2 cajones de estacionamiento y bodega.",
  "published_at": "2026-05-01T09:15:00.000Z",
  "property_type": "apartment"
}
```

## Documentation

## Overview

Vivanuncios (OLX Group) is Mexico's largest classified real estate portal. The platform applies Cloudflare Bot Management (TLS fingerprinting, JavaScript challenges). Piloterr handles the bypass and returns full listing data as structured JSON from a single GET call with the listing URL.

The response includes price, currency, maintenance fee, area, bedrooms, bathrooms, parking, floor, condition, amenities, images, coordinates, and publisher contact.

## Quickstart

```
GET https://api.piloterr.com/v2/vivanuncios/ad?url=https://www.vivanuncios.com.mx/a-venta-de-propiedades/polanco/departamento-en-venta-polanco-v-seccion-3-recamaras-148m2/xxxx/48291037
```

## Main use cases

- Enrich a property database with full listing data from Vivanuncios URLs collected during a search sweep
- Build a price-per-m² heatmap by colonia using real-time coordinates and prices from individual listings
- Monitor a target listing for price changes or status updates as part of a deal-tracking workflow
- Extract amenity lists and building features from Vivanuncios ads to train a property classification model
- Automate due diligence data collection for investment funds evaluating residential assets in Mexico