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

Fotocasa Property Ad API

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

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

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Extract a single listing from fotocasa.es. Pass the full ad URL. Browser rendering. 2 credits per call. Missing or redirected ads return 404.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/fotocasa/ad?query=https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/aire-acondicionado-calefaccion-terraza-ascensor-amueblado/190589697/d

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full fotocasa.es ad URL

Response fieldsLink to Response fields

Field Type Description
id / url / title / description string Identity and copy
operation string sale or rent
property_type string e.g. apartment
status string active
reference string | null Agency reference
published_at string | null Publication datetime
price.amount / currency / price_per_m2 / price_drop number / string Pricing
features object Rooms, area, floor, elevator, terrace, parking, energy class, extras
location object Address, city, neighbourhood, coordinates
agency object Name, alias, phone, type, URL
media.images / thumbnail_url array / string Photos
energy_certificate object Efficiency and emissions

Error codesLink to Error codes

Code Meaning
400 Empty or invalid ad URL
404 Listing not found (hard 404 or soft redirect)
500 Rendering or parse failed

Related endpointsLink to Related endpoints

Related APIs

Expand your data capabilities with these complementary tools.

View All
Fotocasa Property Search/v2/fotocasa/search

Search Fotocasa listings by city or search URL. Returns prices, rooms, area, coordinates, and agency data via 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