# Fotocasa Property Ad

## Overview

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

## Description

Retrieve a full Fotocasa property listing by URL with price, area, rooms, features, coordinates, energy certificate, and agency data 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/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### 3-bedroom apartment in Retiro, Madrid

```json
{
  "id": "191074821",
  "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid/retiro/191074821/d",
  "media": {
    "images": [
      "https://resources.fotocasa.es/listing/listing-image/191074821/1/full.jpg",
      "https://resources.fotocasa.es/listing/listing-image/191074821/2/full.jpg",
      "https://resources.fotocasa.es/listing/listing-image/191074821/3/full.jpg",
      "https://resources.fotocasa.es/listing/listing-image/191074821/4/full.jpg",
      "https://resources.fotocasa.es/listing/listing-image/191074821/5/full.jpg"
    ],
    "thumbnail_url": "https://resources.fotocasa.es/listing/listing-image/191074821/1/xxs.jpg",
    "floor_plan_url": "https://resources.fotocasa.es/listing/floorplan/191074821/1/full.jpg",
    "virtual_tour_url": null
  },
  "price": {
    "amount": 785000,
    "currency": "EUR",
    "negotiable": false,
    "price_drop": null,
    "price_per_m2": 7268,
    "community_fees": 180
  },
  "title": "Piso en Calle Menéndez Pelayo, Retiro",
  "agency": {
    "name": "Engel & Völkers Madrid",
    "type": "agency",
    "phone": "+34 91 521 18 88",
    "website": "https://www.engelvoelkers.com/es/madrid/"
  },
  "status": "active",
  "features": {
    "floor": "3ª",
    "rooms": 3,
    "area_m2": 108,
    "bathrooms": 2,
    "furnished": "unfurnished",
    "has_heating": true,
    "has_parking": false,
    "has_terrace": false,
    "has_elevator": true,
    "total_floors": 6,
    "useful_area_m2": 96,
    "has_storage_room": false,
    "construction_year": 1972,
    "energy_certificate": "C",
    "has_air_conditioning": true
  },
  "location": {
    "city": "Madrid",
    "address": "Calle Menéndez Pelayo, 41",
    "latitude": 40.4117,
    "province": "Madrid",
    "longitude": -3.6814,
    "postal_code": "28009",
    "neighborhood": "Retiro"
  },
  "operation": "sale",
  "reference": "EV-MAD-191074821",
  "updated_at": "2026-04-30T10:15:00.000Z",
  "description": "Magnífico piso de 108 m² en pleno barrio del Retiro, a 200 metros del parque. Tercera planta con ascensor. Distribución: salón comedor, tres dormitorios dobles, dos baños completos, cocina independiente equipada y armarios empotrados en todos los dormitorios. Edificio de obra nueva rehabilitado en 2019. Orientación sur, muy luminoso.",
  "published_at": "2026-04-18T14:30:00.000Z",
  "property_type": "apartment"
}
```

## Documentation

## Overview

Fotocasa runs Cloudflare protection on its listing pages. Piloterr handles the bypass and returns the complete listing as structured JSON: price and price-per-m², community fees, full area breakdown, energy certificate, geo-coordinates, images, and agency contact.

## Quickstart

```
GET https://api.piloterr.com/v2/fotocasa/ad?url=https://www.fotocasa.es/es/comprar/vivienda/madrid/retiro/191074821/d
```

## Main use cases

- Build a CRM enrichment pipeline for Spanish agencies tracking active Fotocasa inventory by district
- Train a property valuation model with price, area, and coordinates from individual listings
- Monitor listing URLs for price reductions or status changes to trigger buyer and investor alerts
- Aggregate energy certificates and community fees across Madrid to map renovation needs and holding costs
- Cross-check Fotocasa listings against Idealista for the same reference to detect specification discrepancies