# Vivanuncios Search

## Overview

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

## Description

Search Vivanuncios Mexico real estate listings by location and get price, area, bedrooms, and agent data 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search apartments for sale in Polanco, CDMX

```json
{
  "page": 1,
  "results": [
    {
      "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",
      "price": 7650000,
      "title": "Departamento en venta en Polanco V Sección, 3 recámaras",
      "area_m2": 148,
      "parking": 2,
      "bedrooms": 3,
      "currency": "MXN",
      "location": {
        "state": "Ciudad de México",
        "municipality": "Miguel Hidalgo",
        "neighborhood": "Polanco V Sección"
      },
      "bathrooms": 2,
      "operation": "sale",
      "thumbnail": "https://img.vivanuncios.com.mx/photos/48291037/1/320x240.jpg",
      "lot_area_m2": null,
      "published_at": "2026-05-01T09:15:00.000Z",
      "property_type": "apartment",
      "publisher_name": "Coldwell Banker México"
    },
    {
      "id": "vv-48319804",
      "url": "https://www.vivanuncios.com.mx/a-venta-de-propiedades/polanco/casa-en-venta-polanco-vi-seccion-5-recamaras-420m2/xxxx/48319804",
      "price": 28500000,
      "title": "Casa en venta en Polanco VI Sección, 5 recámaras",
      "area_m2": 420,
      "parking": 3,
      "bedrooms": 5,
      "currency": "MXN",
      "location": {
        "state": "Ciudad de México",
        "municipality": "Miguel Hidalgo",
        "neighborhood": "Polanco VI Sección"
      },
      "bathrooms": 4,
      "operation": "sale",
      "thumbnail": "https://img.vivanuncios.com.mx/photos/48319804/1/320x240.jpg",
      "lot_area_m2": 310,
      "published_at": "2026-04-28T14:40:00.000Z",
      "property_type": "house",
      "publisher_name": "ERA Inmobiliaria México"
    }
  ],
  "total_results": 4270,
  "results_per_page": 20
}
```

## Documentation

## Overview

Vivanuncios is Mexico's leading classified real estate portal (OLX Group), aggregating hundreds of thousands of sale and rental listings across Ciudad de México, Monterrey, Guadalajara, and all Mexican states. The platform applies Cloudflare Bot Management (TLS fingerprinting, JavaScript challenges). Piloterr handles the bypass and returns paginated listings as structured JSON.

Each result includes price in MXN, construction area, bedroom and bathroom count, parking spaces, colonia, municipality, state, and publisher name.

## Quickstart

```
GET https://api.piloterr.com/v2/vivanuncios/search?location=Polanco,+Ciudad+de+México&operation=sale&property_type=apartment
```

## Main use cases

- Track real-time price per m² by colonia in CDMX to build a Mexican property valuation model that updates daily
- Monitor new listings in Polanco, Santa Fe, and Lomas to catch buying opportunities before they draw investor interest
- Build a rental affordability index by aggregating Vivanuncios prices across Monterrey, Guadalajara, and Cancún
- Collect listing volume and price data by state for quarterly Mexican real estate market reports
- Enrich a brokerage CRM with live competitor listing counts and median prices by neighborhood