Skip to main content
Network status
Log in
Piloterr
Back to library

Fotocasa Property Search API

Search Fotocasa listings by city or search URL. Returns prices, rooms, area, coordinates, and agency data via browser rendering (2 credits).

Active2 credits = 1 requestGET/v2/fotocasa/search
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Search real estate listings on fotocasa.es. Pass a city (madrid, barcelona, valencia…) or a full search URL. Browser rendering. 2 credits per call.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/fotocasa/search?query=madrid&operation=buy
GET https://api.piloterr.com/v2/fotocasa/search?query=barcelona&operation=rent&page=2
GET https://api.piloterr.com/v2/fotocasa/search?query=https://www.fotocasa.es/es/comprar/viviendas/madrid-capital/todas-las-zonas/l

ParametersLink to Parameters

Parameter Type Required Description
query string yes City name or full fotocasa.es search URL
operation string no buy / rent when query is a city. Default: buy
page integer no Page number. Default: 1

Response fieldsLink to Response fields

Field Type Description
listings[] array Property cards
listings[].id / url / title string Fotocasa id, detail URL, title
listings[].price number | null Asking price in EUR
listings[].currency string EUR
listings[].price_drop / price_per_m2 number | null Reduction and €/m²
listings[].rooms / bathrooms / area_m2 / floor integer | null Specs
listings[].property_type / property_subtype string e.g. home / apartment
listings[].operation string sale or rent
listings[].city / neighborhood / address string Location
listings[].latitude / longitude number | null Coordinates
listings[].thumbnail_url string Image
listings[].agency_name string | null Agency
listings[].published_at string | null ISO 8601
meta.current_page / total_pages / total_results integer Pagination
meta.has_next_page boolean More pages
meta.location / operation string Search context

Error codesLink to Error codes

Code Meaning
400 Empty or non-fotocasa.es query
404 Page not found or no listings
500 Rendering or parse failed

Related endpointsLink to Related endpoints

Main use casesLink to Main use cases

  • Index asking prices and €/m² by Spanish city and neighbourhood
  • Feed a map UI with geo-tagged Fotocasa inventory
  • Watch rental vs sale supply across Madrid, Barcelona, Valencia

Related APIs

Expand your data capabilities with these complementary tools.

View All
Fotocasa Property Ad/v2/fotocasa/ad

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

GET2 credits = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert