# Fotocasa Property Search

## Overview

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

## Description

Search Fotocasa real estate listings by location and operation type to get real-time prices, rooms, area, coordinates, and agency data from fotocasa.es 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/fotocasa/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Properties for sale in Madrid

```json
{
  "meta": {
    "location": "madrid",
    "operation": "buy",
    "total_pages": 631,
    "current_page": 1,
    "has_next_page": true,
    "total_results": 18922
  },
  "listings": [
    {
      "id": "188446273",
      "url": "https://www.fotocasa.es/es/comprar/vivienda/ciempozuelos/aire-acondicionado-calefaccion-parking-terraza-trastero-ascensor-no-amueblado/188446273/d",
      "city": "Ciempozuelos",
      "floor": "1ª",
      "price": 255900,
      "rooms": 3,
      "title": "Piso con terraza en Calle de la Reina Victoria, Casco Antiguo Sur",
      "area_m2": 159,
      "currency": "EUR",
      "latitude": 40.1607,
      "bathrooms": 2,
      "longitude": -3.6243,
      "operation": "sale",
      "price_drop": 9000,
      "agency_name": "Hogares Ciempozuelos",
      "has_parking": true,
      "has_terrace": true,
      "has_elevator": true,
      "neighborhood": "Casco Antiguo Sur",
      "price_per_m2": 1610,
      "published_at": "2026-01-12T09:00:00.000Z",
      "property_type": "apartment",
      "thumbnail_url": "https://resources.fotocasa.es/listing/listing-image/188446273/1/xxs.jpg"
    },
    {
      "id": "191074821",
      "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid/retiro/191074821/d",
      "city": "Madrid",
      "floor": "3ª",
      "price": 785000,
      "rooms": 3,
      "title": "Piso en Calle Menéndez Pelayo, Retiro",
      "area_m2": 108,
      "currency": "EUR",
      "latitude": 40.4117,
      "bathrooms": 2,
      "longitude": -3.6814,
      "operation": "sale",
      "price_drop": null,
      "agency_name": "Engel & Völkers Madrid",
      "has_parking": false,
      "has_terrace": false,
      "has_elevator": true,
      "neighborhood": "Retiro",
      "price_per_m2": 7217,
      "published_at": "2026-04-18T14:30:00.000Z",
      "property_type": "apartment",
      "thumbnail_url": "https://resources.fotocasa.es/listing/listing-image/191074821/1/xxs.jpg"
    }
  ]
}
```

## Documentation

## Overview

Fotocasa is one of Spain's leading real estate portals. The site uses Cloudflare bot protection. Piloterr handles the bypass and returns paginated property listings with live prices, price-per-m², geo-coordinates, room counts, and agency data as structured JSON.

## Quickstart

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

## Main use cases

- Build a Spanish property market index using asking prices and price-per-m² by district
- Populate a map-based search interface with live, geo-tagged Fotocasa listings
- Monitor price drops to trigger automated alerts for saved neighbourhood searches
- Train a property valuation model with room counts, areas, and prices by district
- Feed a real estate CRM with new listings matching specific buyer criteria in real time