Spotahome Mid-Term Rentals Scraper

Scrape Spotahome.com — the mid/long-term furnished rental marketplace covering 92 cities across Europe, the UAE and Turkey. Search rooms, apartments, studios and co-living residences by city, filter by price and bedrooms, or fetch specific listing URLs. Every listing is video-verified by Spotahome before going live.

What this actor does

• Two modes: search (city + property-type + bedrooms browsing) and byUrls (fetch specific listing URLs you already have)
• 92 cities: every Spotahome market across Spain, Italy, France, Germany, the UK, Ireland, Benelux, the Nordics, Poland, the Baltics, Austria, Switzerland, Portugal, Greece, Turkey, Malta, Cyprus, Hungary, Slovenia and the UAE
• 4 property types: rooms (shared flats), apartments (whole units), studios, residences (co-living/student housing)
• Bedroom filter: for apartments, browse by exact bedroom count (1, 2, 3, 3+)
• Price range filter: min/max monthly rent in the city's local currency (EUR for most cities, local currency for a few non-Eurozone markets — see FAQ), applied server-side on Spotahome's own search
• Bathroom filter: exact bathroom count (1, 2, 3+)
• Move-in date range: only browse listings available from/to specific dates
• No-deposit filter: only listings that skip the security deposit
• Instant-booking filter: only listings that can be booked immediately without landlord approval
• Verified filter: only listings Spotahome has physically verified
• Full detail enrichment (optional): exact address, GPS coordinates, bedroom/bathroom counts, floor size, occupancy limits, pets/smoking policy, full amenity list, lease-length terms, and the complete photo gallery — extracted from each listing's own structured data
• Empty fields are omitted — every record only contains fields Spotahome actually published for that listing

Output per listing

• id, title, description, propertyType
• price, currencySymbol, currencyCode, priceValidUntil, isAvailable
• leaseMinMonths, leaseMaxMonths
• addressStreet, addressCity, addressPostalCode, addressCountry, cityName, countryName
• latitude, longitude
• bedrooms, bathrooms, floorSizeSqm, occupancyMin, occupancyMax
• petsAllowed, smokingAllowed, amenities[]
• rating, reviewCount
• availableFrom, tags[] (from the search card, e.g. CHECKED, BILLS INCLUDED, UP TO 5% OFF)
• imageUrl, imageUrls[], imageCount
• sourceUrl — the canonical Spotahome.com listing page
• recordType: "listing", scrapedAt

Input

Field	Type	Default	Description
mode	select	search	search / byUrls
city	select	barcelona	One of 92 cities (mode=search)
propertyType	select	all	all / rooms / apartments / studios / residences (mode=search)
bedrooms	select	any	any / 1 / 2 / 3 / 3more — only applies when propertyType=apartments
minPrice	int	–	Only browse listings priced at or above this, in the city's local currency (usually EUR, see FAQ); server-side filter
maxPrice	int	–	Only browse listings priced at or below this, in the city's local currency (usually EUR, see FAQ); server-side filter
bathrooms	select	any	any / 1 / 2 / 3 — exact bathroom count; server-side filter
moveInFrom	string	–	Only browse listings available to move into on/after this date (YYYY-MM-DD)
moveInTo	string	–	Only browse listings available to move into on/before this date (YYYY-MM-DD)
noDeposit	bool	false	Only keep listings that don't require a security deposit
instantBooking	bool	false	Only keep listings that can be booked instantly, no landlord approval wait; server-side filter
verifiedOnly	bool	false	Only keep listings Spotahome has physically verified; server-side filter
minBedrooms	int	–	Drop listings with fewer bedrooms than this (needs includeDetails=true)
startUrls	array	–	Direct Spotahome.com listing URLs (mode=byUrls)
includeDetails	bool	false	Fetch each listing's detail page for address, coordinates, amenities, lease terms, full gallery
maxItems	int	30	Hard cap on emitted records (1–2000)

Example: rooms in Barcelona under €700/month

{
  "mode": "search",
  "city": "barcelona",
  "propertyType": "rooms",
  "maxPrice": 700,
  "maxItems": 50
}

Example: 2-bedroom apartments in Madrid, full details

{
  "mode": "search",
  "city": "madrid",
  "propertyType": "apartments",
  "bedrooms": "2",
  "maxItems": 30,
  "includeDetails": true
}

Example: rooms in Barcelona, €400-700/mo, no deposit, move in from September

{
  "mode": "search",
  "city": "barcelona",
  "propertyType": "rooms",
  "minPrice": 400,
  "maxPrice": 700,
  "noDeposit": true,
  "moveInFrom": "2026-09-01",
  "maxItems": 50
}

Example: fetch specific listing URLs

{
  "mode": "byUrls",
  "startUrls": ["https://www.spotahome.com/barcelona/for-rent:rooms/1003961"]
}

Use cases

• Relocation / expat housing search — pull all rooms or apartments in a target city into a spreadsheet
• Market research — track mid-term rental prices across European cities
• Corporate housing sourcing — screen furnished apartments with specific bedroom counts and amenities
• Real estate analytics — compare price-per-city or price-per-neighborhood trends
• Content aggregation — feed a relocation or rental-comparison platform

Limitations

• Bedroom filtering is exact-count and apartments-only. Spotahome's own site only exposes a bedroom-count filter for the apartments property type; rooms/studios/residences don't have a bedroom filter on the site itself.
• minPrice/maxPrice/bathrooms/moveInFrom/moveInTo/noDeposit/instantBooking/verifiedOnly are real server-side filters applied directly on Spotahome's own search (not a client-side post-filter), so narrow ranges stay fast and don't need a higher maxItems to find matches.
• minBedrooms (search mode) requires includeDetails=true. Bedroom counts for search-card results other than the apartments bedroom-count filter are only available from each listing's detail page.
• Amenity/feature filtering isn't exposed. Spotahome's search supports an internal features[] filter (wifi, elevator, balcony, etc.) but its full valid value list isn't part of any public API contract, so exposing it risked shipping silently-wrong values; the full amenity list is still available per-listing via includeDetails=true.

FAQ

What's Spotahome? A European mid/long-term rental marketplace (minimum stays typically 1+ months) where every property is professionally photographed and video-verified before listing — popular for relocations, remote work, and student housing.

Which currency are prices in? Euro (EUR) for the large majority of covered markets. A handful of non-Eurozone cities are priced in their local currency instead: London/Manchester/Edinburgh/Glasgow/Nottingham (GBP), Zurich (CHF), Copenhagen (DKK), Stockholm (SEK), Prague (CZK), Budapest (HUF), the Polish cities — Warsaw, Kraków, Gdańsk, Katowice, Lublin, Poznań, Wrocław, Łódź (PLN), Istanbul (TRY), and Dubai (AED). Each record's currencyCode/currencySymbol fields always reflect the actual listing currency.

What's the difference between a "room" and a "studio"? A room is a private bedroom in a shared flat (other tenants share common areas); a studio is a self-contained unit with no flatmates.

Why is includeDetails off by default? The search page already returns price, property type, availability date, rating and tags — enough for a quick browse. Turning on includeDetails fetches each listing's own page for the exact address, coordinates, bedroom/bathroom counts, floor size, full amenity list and lease terms — more complete but roughly 2x slower.

How many listings can I pull at once? Up to 2000 per run.

Are all 92 cities equally well covered? No — inventory varies enormously (Barcelona and Madrid have thousands of listings; smaller cities may have only a handful). The actor returns whatever is currently live.