REAL ESTATE · SPAIN
Fotocasa: Spain Property Listings
Fotocasa API for Spanish real estate.
About this data
Fotocasa API for Spanish real estate. Paste any fotocasa.es search URL or pick a location; get one clean record per home for sale or rent with price in EUR, m², bedrooms, bathrooms, address, photo and listing URL.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/es/fotocasa/listings
Live property listings from Fotocasa, one of Spain's largest real-estate portals, for a location slug (e.g. madrid-provincia, barcelona-capital, valencia-capital) and optional zone, for sale or rent: price in EUR, area in m2, rooms, bathrooms, address, property type, agency phone where shown, image and listing URL.
First results page only, up to 30 listings per call; the residential proxy is included in the price.
Input
Send a JSON body to POST https://api.ssh.autos/v1/es/fotocasa/listings.
| Field | Type | Required | Notes |
|---|---|---|---|
location | string | optional | up to 80 characters; pattern ^[a-z0-9]+(-[a-z0-9]+)*$; default "madrid-provincia" |
zone | string | optional | up to 80 characters; pattern ^[a-z0-9]+(-[a-z0-9]+)*$; default "todas-las-zonas" |
operation | string | optional | one of sale, rental; default "sale" |
sortType | string | optional | one of scoring, publication, price-asc, price-desc; default "scoring" |
maxResults | integer | optional | 1–30; default 10 |
Returned fields
The answer is JSON: records, a list of up to 30, and summary, the run status and counts. Each record has these 19 fields; a field the source does not publish comes back null.
19 fields per record
| Field | Type | Notes |
|---|---|---|
id | string | Fotocasa numeric listing id from the URL (/es/comprar/vivienda/{location}/{slug}/{id}/d). |
listingKey | string | Composite unique key: source:id (e.g. fotocasa.es:190550668). |
url | string | Canonical listing URL on www.fotocasa.es, tracking query parameters removed. |
name | string | Listing card title. |
price | number | Advertised price amount; for rentals the monthly amount ('/mes' dropped). Spanish formatting ('365.000 €' → 365000). Null for 'Precio a consultar'. |
currency | string | Currency of price: always EUR on fotocasa.es. Null when the card shows no price. |
areaM2 | number | Built area in m² from the card detail chips ('120 m²', '86 m² constr.'). |
rooms | integer | Bedrooms from the card chips ('3 hab.'). |
bedrooms | integer | Same as rooms: fotocasa cards expose 'hab.' (bedrooms) only. |
bathrooms | integer | Bathrooms from the card chips ('2 baños'). |
address | string | Location line from the card (re-CardLocation dialect or <address>). |
phone | string | Published listing phone for all client types, including private owners, preserving source formatting. Unavailable phones remain null. |
imageUrl | string | Primary card image URL on the Fotocasa CDN. |
operation | string | Requested operation: 'sale' or 'rental'. |
propertyType | string | Searched property type: 'viviendas' for form searches; a pasted search URL gives its own type (e.g. 'pisos', 'casas'). |
portal | string | Portal slug the record came from ('fotocasa'). |
country | string | Portal country: ES. |
source | string | Source website hostname (www.fotocasa.es). |
scrapedAt | string | UTC ISO-8601 collection timestamp. |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/es/fotocasa/listings -m POST -b '{"location": "valencia-capital", "maxResults": 3}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Fotocasa Scraper: Spain Property Listings API. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt