# Habitaclia Property Ad

## Overview

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

## Description

Fetch a Habitaclia property listing by URL and get price, area, rooms, amenities, energy rating, price history, and agency contact from habitaclia.com 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/habitaclia/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Apartment in Barcelona Eixample

```json
{
  "id": "58600185678",
  "url": "https://www.habitaclia.com/comprar-piso-en-barcelona/inmueble-piso_barcelona-58600185678.htm",
  "city": "Barcelona",
  "floor": "3ª",
  "price": 495000,
  "rooms": 3,
  "title": "Piso reformado en Eixample Dret, Carrer de Provença",
  "photos": [
    "https://static.habitaclia.com/fotografias/piso-en-barcelona-58600185678-1.jpg",
    "https://static.habitaclia.com/fotografias/piso-en-barcelona-58600185678-2.jpg",
    "https://static.habitaclia.com/fotografias/piso-en-barcelona-58600185678-3.jpg"
  ],
  "status": "active",
  "address": "Carrer de Provença, 281",
  "area_m2": 90,
  "currency": "EUR",
  "has_pool": false,
  "latitude": 41.3952,
  "province": "Barcelona",
  "bathrooms": 2,
  "condition": "good",
  "longitude": 2.1726,
  "operation": "sale",
  "video_url": null,
  "agency_url": "https://www.habitaclia.com/agencia/comprarcasa-barcelona-eixample",
  "has_garden": false,
  "updated_at": "2026-05-10T09:15:00.000Z",
  "agency_name": "Comprarcasa Barcelona Eixample",
  "description": "Magnifico piso reformado en el corazón del Eixample Dret. Distribuido en salón-comedor, cocina independiente equipada, 3 habitaciones dobles con armarios empotrados y 2 baños completos. El inmueble cuenta con aire acondicionado, suelos de parquet y carpintería de madera. Edificio con ascensor. Imprescindible visitar.",
  "has_heating": true,
  "has_parking": false,
  "has_storage": false,
  "has_terrace": false,
  "orientation": "south",
  "postal_code": "08008",
  "agency_phone": "+34 932 XX XX XX",
  "has_elevator": true,
  "is_new_build": false,
  "neighborhood": "Eixample Dret",
  "price_per_m2": 5500,
  "published_at": "2026-02-01T09:15:00.000Z",
  "energy_rating": "D",
  "is_bank_owned": false,
  "price_history": [
    {
      "date": "2026-02-01T00:00:00.000Z",
      "price": 510000
    },
    {
      "date": "2026-04-15T00:00:00.000Z",
      "price": 495000
    }
  ],
  "property_type": "apartment",
  "useful_area_m2": 82,
  "emissions_rating": "D",
  "virtual_tour_url": null,
  "has_air_conditioning": true,
  "has_fitted_wardrobes": true,
  "energy_consumption_kwh": 143.2
}
```

## Documentation

## Overview

Habitaclia listing pages contain full property data: price history, amenity flags, energy certificate class, geo-coordinates, and agency contact. The site runs Cloudflare. Piloterr handles the bypass and returns the complete structured record for any listing URL.

## Quickstart

```
GET https://api.piloterr.com/v2/habitaclia/ad?query=https://www.habitaclia.com/comprar-piso-en-barcelona/inmueble-piso_barcelona-58600185678.htm
```

## Main use cases

- Enrich CRM buyer records with live Habitaclia property data at the moment a buyer expresses interest
- Track price history on watched listings to advise buyers on negotiation timing
- Collect energy certificate classes across districts to study efficiency-price correlations in the Spanish market
- Build a property comparison tool pulling full amenity specs for multiple listings in real time
- Audit competitor listings to benchmark your agency's inventory against market pricing