Piloterr

Fotocasa Property Ad

GET
/v2/fotocasa/ad

Get a full Fotocasa listing by URL: price, features, coordinates, energy certificate, images, and agency (browser rendering, 2 credits).

Credit cost: 2 credits per call

Autorisierung

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Abfrageparameter

query*string

Full Fotocasa ad URL (/comprar/ or /alquiler/, ending with /d).

Examples:

https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/aire-acondicionado-calefaccion-terraza-ascensor-amueblado/190589697/d
https://www.fotocasa.es/es/alquiler/vivienda/madrid-capital/aire-acondicionado-ascensor-amueblado/190625587/d

Antworttext

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/fotocasa/ad?query=string"

{  "id": "190589697",  "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/aire-acondicionado-calefaccion-terraza-ascensor-amueblado/190589697/d",  "media": {    "images": [      "https://static.fotocasa.es/images/ads/0fe8c038-bcae-4028-aa77-840986d1562d?rule=original",      "https://static.fotocasa.es/images/ads/c41d1c6c-a6b8-4c66-8957-6986220698a8?rule=original",      "https://static.fotocasa.es/images/ads/4f18df17-d595-4622-b0e9-b9f911cf4741?rule=original",      "https://static.fotocasa.es/images/ads/3086bd1e-6ceb-415e-86cf-1766f7f9a5cd?rule=original",      "https://static.fotocasa.es/images/ads/73448974-39a0-4bb4-9b26-3e14c6e8d039?rule=original"    ],    "thumbnail_url": "https://static.fotocasa.es/images/ads/0fe8c038-bcae-4028-aa77-840986d1562d?rule=original"  },  "price": {    "amount": 244000,    "currency": "EUR",    "price_drop": null,    "price_per_m2": 4692  },  "title": "Apartamento en venta en Calle de Zabalza, Simancas, Madrid Capital",  "agency": {    "url": "https://www.fotocasa.es/es/inmobiliaria--vohome-julián-camarillo---simancas/comprar/viviendas/espana/todas-las-zonas/l",    "name": "VO HOME JULIAN CAMARILLO - SIMANCAS",    "type": "professional",    "alias": "VOhome Julián Camarillo - Simancas",    "phone": "+34910149999"  },  "status": "active",  "features": {    "floor": "4ª planta",    "rooms": 2,    "extras": [      "Aire acondicionado",      "Calefacción",      "Terraza",      "Ascensor",      "Amueblado",      "Balcón",      "Alarma",      "Puerta Blindada"    ],    "area_m2": 52,    "bathrooms": 1,    "furnished": true,    "has_heating": true,    "has_parking": false,    "has_terrace": true,    "orientation": "Noreste",    "has_elevator": true,    "energy_certificate": "F",    "has_air_conditioning": true  },  "location": {    "city": "Madrid",    "address": "Calle de Zabalza",    "district": "San Blas",    "latitude": 40.42925376395859,    "province": "Madrid",    "longitude": -3.624235493745569,    "postal_code": "28037",    "neighborhood": "Simancas"  },  "operation": "sale",  "reference": "145",  "description": "VOhome Propiedades Simancas vende piso ubicado en Calle Zabalza en el barrio de Simancas.\r\n\r\nEsta acogedora vivienda se distribuye a través de un práctico pasillo de entrada que da acceso a un amplio y muy luminoso salón-comedor, perfecto para disfrutar de la luz natural durante todo el día. Cuenta con una cocina independiente totalmente equipada, dos dormitorios confortables y un baño completo co…",  "published_at": "2026-08-28T14:03:58.087",  "property_type": "apartment",  "energy_certificate": {    "emissions": "E",    "efficiency": "F",    "emissions_value": 61,    "efficiency_value": 328  }}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}