GET
Search
/api/fotocasa/search
Search Fotocasa listings by vertical, transaction type and location, with facets and pagination
Fotocasa API
Spanish Real Estate Data — Listings, Details, and the Fotocasa Research Index
Search Fotocasa property listings, get full listing details, resolve locations, and read the official Fotocasa Research price index. Fotocasa is Spain's largest property portal; Scrappa exposes every in-scope vertical, including shared rooms (habitaciones) and rent with option to buy, as structured JSON.
500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
7
Endpoints
Spain
Market
$0.20
Per 1k requests
Try it now
Make one request. Inspect structured JSON.
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
Request preview
Request
curl -X GET "https://scrappa.co/api/fotocasa/search?property_type=2&transaction_type=5&size=5" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
JSON response
{
"success": true,
"data": {
"total_items": 14821,
"items": [
{
"id": "5_189620013",
"property_type": 2,
"property_type_label": "home",
"transaction_type": 5,
"transaction_type_label": "share",
"surface": 12,
"rooms": 1
}
]
}
}What you can build
Structured data for real applications. Here are some ideas.
Spanish Property Search
Build property search for Spain across homes, garages, land, commercial premises, offices and storage rooms, for sale, rent, shared rooms and rent with option to buy — all from one endpoint with consistent filters.
Rental Market Analysis
Compare rent and sale medians by province using the Fotocasa Research index, and track listing supply per vertical to size a market before committing to a search strategy.
Agency Coverage Monitoring
Track how much inventory a given agency holds by querying its numeric client id, then alert on changes across portals for the same agency.
Listing Aggregation
Combine Fotocasa with Idealista and other Spanish portals to build comparison tools. Deduplicate by listing id, address and coordinates to avoid double counting the same property.
Available endpoints
Everything you need in one API.
GET
Listing Detail
/api/fotocasa/listing
Get the full detail record for one listing, including description, media and energy certificate
GET
Autocomplete
/api/fotocasa/locations
Resolve a place name to the location chain every Fotocasa endpoint accepts
GET
Location Geometry
/api/fotocasa/polygons
Get polygon geometry for a country, region or municipality
GET
Map Search
/api/fotocasa/map-search
Search listings around a map centre for pin-level results
GET
Agency
/api/fotocasa/agency
Get agency inventory by numeric client id, or the agency minisite page by slug
GET
Price Index
/api/fotocasa/price-index
Get the Fotocasa Research sale and rent medians by province
Scrappa vs Fotocasa (no public API)
See how Scrappa compares to the official API.
| Feature | Scrappa | Fotocasa (no public API) |
|---|---|---|
| API available | Yes (7 endpoints) | No public API |
| Property search | Programmatic | Manual only |
| Property details | Structured JSON | Not available |
| Shared rooms (habitaciones) | Not exposed | |
| Location autocomplete | On-site only | |
| Price index | Report only | |
| Bulk access | ||
| Free tier | 500 credits/month | N/A |
| Integration ready | REST API |
API available
Scrappa:
Yes (7 endpoints)
Fotocasa (no public API):
No public API
Property search
Scrappa:
Programmatic
Fotocasa (no public API):
Manual only
Property details
Scrappa:
Structured JSON
Fotocasa (no public API):
Not available
Shared rooms (habitaciones)
Scrappa:
Fotocasa (no public API):
Not exposed
Location autocomplete
Scrappa:
Fotocasa (no public API):
On-site only
Price index
Scrappa:
Fotocasa (no public API):
Report only
Bulk access
Scrappa:
Fotocasa (no public API):
Free tier
Scrappa:
500 credits/month
Fotocasa (no public API):
N/A
Integration ready
Scrappa:
REST API
Fotocasa (no public API):
Key features
Every in-scope Spanish vertical: homes, garages, land, commercial, offices and storage rooms
All four live transaction types: sale, rent, shared rooms and rent with option to buy
Full listing detail with description, media and energy certificate
Location autocomplete and polygon geometry for country, region and municipality
Agency inventory by numeric client id
The official Fotocasa Research price index for all 52 provinces
Enum ids arrive labelled, never as bare numerics
Agency phone numbers are withheld from responses
No login, contact form or saved-search access — read-only public listing data
Structured JSON response format
Frequently asked questions
Fotocasa does not offer a public API. Scrappa provides 7 structured REST endpoints to search, resolve locations, fetch listing detail and read the price index programmatically, without manual browsing.
Yes. transaction_type=5 covers shared rooms (habitaciones) and transaction_type=7 covers rent with option to buy. Both are live, sizeable segments of the Spanish rental market and are first-class filters, not hidden behind a property type.
Just a Scrappa API key passed as an X-API-KEY header. No Fotocasa account, no partner program, no OAuth. Sign up for free, get your key, and start querying property data immediately.
No. The phone number on a Fotocasa listing is public listing content but personal-adjacent, so Scrappa withholds it from responses rather than republishing it.
Yes. Every Scrappa account gets 500 free credits per month with no credit card required. Test all Fotocasa endpoints before committing to paid usage.
Scrappa charges $0.20 per 1,000 requests with no daily caps and never rate limits a client. All Fotocasa endpoints cost the same. Failed requests are never billed.