# ZonaProp Ad

## Overview

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

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Fetch a single ZonaProp Argentina listing by URL and get full details: price, area, rooms, amenities, coordinates, and agency info 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/zonaprop/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Fetch listing by URL

```json
{
  "id": "zp-prop-49182731",
  "url": "https://www.zonaprop.com.ar/propiedades/departamento-3-ambientes-palermo-49182731.html",
  "area": {
    "total_m2": 78,
    "covered_m2": 66,
    "uncovered_m2": 12
  },
  "price": {
    "amount": 148000,
    "currency": "USD",
    "expenses": 85000,
    "price_per_m2": 1897,
    "ars_equivalent": 148000000
  },
  "title": "Departamento 3 ambientes en venta en Palermo Hollywood",
  "images": [
    "https://img.zonaprop.com.ar/photos/49182731/1/1024x768.jpg",
    "https://img.zonaprop.com.ar/photos/49182731/2/1024x768.jpg",
    "https://img.zonaprop.com.ar/photos/49182731/3/1024x768.jpg",
    "https://img.zonaprop.com.ar/photos/49182731/4/1024x768.jpg"
  ],
  "status": "active",
  "features": {
    "age": "2019",
    "floor": "8",
    "rooms": 3,
    "parking": 1,
    "toilets": 1,
    "bedrooms": 2,
    "bathrooms": 1,
    "condition": "Muy bueno"
  },
  "location": {
    "lat": -34.5831,
    "lng": -58.4371,
    "city": "Buenos Aires",
    "address": "Nicaragua al 5200, Palermo Hollywood",
    "province": "CABA",
    "neighborhood": "Palermo Hollywood"
  },
  "amenities": [
    "Pileta",
    "Gimnasio",
    "Seguridad 24hs",
    "Cochera",
    "Parrilla",
    "SUM",
    "Laundry",
    "Bici-espacio"
  ],
  "operation": "sale",
  "publisher": {
    "id": "re-agency-7291",
    "name": "Inmobiliaria RE/MAX Palermo",
    "type": "real_estate_agency",
    "profile_url": "https://www.zonaprop.com.ar/inmobiliarias/remax-palermo.html",
    "total_listings": 142
  },
  "thumbnail": "https://img.zonaprop.com.ar/photos/49182731/1/320x240.jpg",
  "updated_at": "2026-04-30T08:30:00.000Z",
  "description": "Espectacular departamento de 3 ambientes en el corazón de Palermo Hollywood. Piso 8, luminoso con frente al boulevard. Cuenta con living-comedor, cocina americana equipada, 2 dormitorios (uno en suite), 1 baño completo y toilette. Balcón corrido de 12 m². Edificio de categoría con amenities completos. A 2 cuadras del subte D. Precio con cochera incluida.",
  "published_at": "2026-04-28T10:00:00.000Z",
  "property_type": "apartment"
}
```

## Documentation

## Overview

ZonaProp blocks automated requests with Cloudflare. Piloterr absorbs the infrastructure layer: pass a listing URL and receive the full property ad as structured JSON in real time.

The response covers price in USD with ARS equivalent, price per m², total and covered area, rooms, floor, parking, building amenities, photos, coordinates, and publisher details.

## Quickstart

```
GET https://api.piloterr.com/v2/zonaprop/ad?url=https://www.zonaprop.com.ar/propiedades/departamento-3-ambientes-palermo-49182731.html
```

## Main use cases

- Enrich property valuation models with full ZonaProp listing details including price per m², area, and amenities
- Build sold-price datasets by recording listing prices before status changes to `sold`
- Extract agency-level data by comparing `publisher.total_listings` across firms in a target neighborhood
- Track price changes on specific listings to identify negotiation patterns in Buenos Aires
- Collect building amenity data at scale to build a neighborhood quality index