# Habitaclia Property Search

## Overview

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

## Description

Search Habitaclia listings in real time by location and operation type, returning price, area, rooms, coordinates, and agency data 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Properties for sale in Barcelona

```json
{
  "meta": {
    "location": "barcelona",
    "operation": "buy",
    "total_pages": 1711,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 51334
  },
  "listings": [
    {
      "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 en Eixample Dret, Carrer de Provença",
      "area_m2": 90,
      "currency": "EUR",
      "latitude": 41.3952,
      "bathrooms": 2,
      "longitude": 2.1726,
      "operation": "sale",
      "price_drop": 15000,
      "agency_name": "Comprarcasa Barcelona Eixample",
      "has_parking": false,
      "has_terrace": false,
      "has_elevator": true,
      "is_new_build": false,
      "neighborhood": "Eixample Dret",
      "price_per_m2": 5500,
      "published_at": "2026-05-10T09:15:00.000Z",
      "property_type": "apartment",
      "thumbnail_url": "https://static.habitaclia.com/fotografias/piso-en-barcelona-58600185678-1.jpg",
      "has_air_conditioning": true
    },
    {
      "id": "58600291034",
      "url": "https://www.habitaclia.com/comprar-piso-en-barcelona/inmueble-piso_barcelona-58600291034.htm",
      "city": "Barcelona",
      "floor": "1ª",
      "price": 380000,
      "rooms": 2,
      "title": "Piso con terraza en Gràcia, Carrer de Verdi",
      "area_m2": 90,
      "currency": "EUR",
      "latitude": 41.4033,
      "bathrooms": 1,
      "longitude": 2.1554,
      "operation": "sale",
      "price_drop": null,
      "agency_name": null,
      "has_parking": false,
      "has_terrace": true,
      "has_elevator": false,
      "is_new_build": false,
      "neighborhood": "Gràcia",
      "price_per_m2": 4222,
      "published_at": "2026-05-08T14:00:00.000Z",
      "property_type": "apartment",
      "thumbnail_url": "https://static.habitaclia.com/fotografias/piso-en-barcelona-58600291034-1.jpg",
      "has_air_conditioning": false
    }
  ]
}
```

## Documentation

## Overview

Habitaclia is one of Spain's largest real estate portals, part of the Fotocasa Group, with over 760,000 active listings. The site runs Cloudflare bot protection. Piloterr handles the bypass and returns paginated property listings with live prices, price-per-m², geo-coordinates, room counts, and amenity flags as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/habitaclia/search?location=barcelona&operation=buy
```

## Main use cases

- Build a Spanish property market index using asking prices and price-per-m² by district, updated in real time from Habitaclia
- Populate a map-based search interface with live, geo-tagged Habitaclia listings across all Spanish provinces
- Monitor price drops to trigger automated buyer alerts for saved neighbourhood searches
- Train a property valuation model using room counts, areas, and price history by city
- Feed a real estate CRM with new listings matching buyer criteria as they are published on Habitaclia