Fotocasa Property Search
Search Fotocasa listings by city or search URL. Returns prices, rooms, area, coordinates, and agency data via browser rendering (2 credits).
Credit cost: 2 credits per call
Autorização
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parâmetros de consulta
query*string
City name or full Fotocasa search URL.
Examples:
madridbarcelonahttps://www.fotocasa.es/es/comprar/viviendas/madrid-capital/todas-las-zonas/lhttps://www.fotocasa.es/es/alquiler/viviendas/barcelona-capital/todas-las-zonas/l/2operation?string
Used when query is a city name (ignored for full URLs).
buy/comprar: for sale (default)rent/alquiler: for rent
Default
"buy"page?number
Page number (1-based). Default: 1. Page 2 maps to /l/2.
Default
"1"Corpo da resposta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/fotocasa/search?query=string"{ "meta": { "location": "Madrid", "operation": "sale", "total_pages": 375, "current_page": 1, "has_next_page": true, "total_results": 11222 }, "listings": [ { "id": "189717534", "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/aire-acondicionado-ascensor-amueblado/189717534/d", "city": "Madrid", "floor": null, "price": 990000, "rooms": 3, "title": "Barrio de Salamanca", "address": "Barrio de Salamanca", "area_m2": 99, "currency": "EUR", "latitude": 40.43689191820105, "bathrooms": 2, "longitude": -3.677214968590556, "operation": "sale", "price_drop": null, "agency_name": "Dils Lucas Fox", "neighborhood": "Barrio de Salamanca", "price_per_m2": 10000, "published_at": "2026-05-19T04:07:34.000Z", "property_type": "home", "thumbnail_url": "https://static.fotocasa.es/images/ads/18ce6fc9-f80b-415f-b538-a150d35c7073?rule=original", "property_subtype": "apartment" }, { "id": "189625641", "url": "https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/aire-acondicionado-calefaccion-terraza-trastero-ascensor-amueblado/189625641/d", "city": "Madrid", "floor": 12, "price": 1620000, "rooms": 3, "title": "Alcalá, Barrio de Salamanca", "address": "Alcalá, Barrio de Salamanca", "area_m2": 130, "currency": "EUR", "latitude": 40.42785333292837, "bathrooms": 2, "longitude": -3.672679393562349, "operation": "sale", "price_drop": null, "agency_name": "ESPÍGUL IMMOBILIARIA", "neighborhood": "Barrio de Salamanca", "price_per_m2": 12462, "published_at": "2026-05-08T15:08:35.000Z", "property_type": "home", "thumbnail_url": "https://static.fotocasa.es/images/ads/f8a5ccd4-ccf2-4012-9584-ba97c261b3ff?rule=original", "property_subtype": "penthouse" } ]}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}