Rental Search
/api/spotahome/search
Search Spotahome rentals in a city with price, type and move-in filters and 48 listings per page
Scrappa's Spotahome API returns structured JSON from Spotahome, the European platform for furnished mid and long-term rentals. Search rooms, apartments, studios and residences by city with price, property type and move-in filters, and open any listing for its monthly price, availability and stay rules, booking terms, amenities, bills, house rules, landlord summary and photos. Scrappa is an independent service and is not affiliated with or endorsed by Spotahome.
Try it now
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.
curl -X GET "https://scrappa.co/api/spotahome/search?city=madrid&country=spain&min_price=500&max_price=900&type=studios" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"city": {
"id": "madrid",
"name": "Madrid",
"country_code": "ES",
"currency": "EUR"
},
"total_results": 9704,
"total_pages": 203,
"page": 1,
"has_more": true,
"listings": [
{
"position": 1,
"id": "80504",
"title": "Room in shared apartment for rent in Gaztambide, Madrid",
"url": "https://www.spotahome.com/madrid/for-rent:rooms/80504",
"type": "room_shared",
"property_type": "rooms",
"price": 660,
"currency": "EUR",
"available_from": "2027-01-31",
"bills_included": "none",
"bedrooms": 5,
"bathrooms": 2,
"is_instant_booking": false,
"is_checked": true,
"no_security_deposit": false,
"has_deposit_protection": false,
"address": {
"street": "Guzman el Bueno",
"postal_code": "28015",
"city": "Madrid"
},
"latitude": 40.43137,
"longitude": -3.71313,
"main_photo_url": "https://photos.spotahome.com/smw_768/11f7eb0b4a5bf48d04be29239ad3f231f75e0b0d1b11b3df3845577a.jpg",
"photo_urls": [
"https://photos.spotahome.com/smww_768_verified_ur_6_50/11f7eb0b4a5bf48d04be29239ad3f231f75e0b0d1b11b3df3845577a.jpg"
],
"description": "This spacious and well-furnished room is located in a shared 5-bedroom apartment in the Gaztambide neighborhood of Madrid. The apartment includes features such as a private washing machine, equipped kitchen with an oven, heating system, and a television for tenant use. Spotahome has personally checked and verified this property."
}
],
"next_page": 2
},
"meta": {
"endpoint_family": "search_city",
"billable": true
}
}
Structured data for real applications. Here are some ideas.
Track monthly asking prices for rooms, studios and apartments in Madrid, Berlin, Paris, Milan and more, filtered by budget and property type.
Search furnished rentals by city and move-in date and show real availability, minimum stay and photos inside your relocation product.
Read available, unavailable and move-in date ranges plus minimum and maximum stay for any listing to detect when a place opens up.
Compare supply, price ranges and bills included across European cities with the total result counts returned by every search.
Add amenities, house rules, deposit terms and landlord type to a rental database from a single listing request.
Spotahome scraper API
The Spotahome API is built for relocation tools, rental analytics and housing search features. Each search result includes the id, title, public url, monthly price with currency, first available date, bedrooms, bathrooms, address, coordinates and photos. Detail responses add availability ranges, stay rules, deposit and fee terms, amenities, bills, house rules and the landlord summary.
Search by city and country slug with budget, property type and move-in date filters.
Page through 48 listings per page with total_results, total_pages, has_more and next_page.
Read monthly price, currency, minimum and maximum stay and date ranges per listing.
Get photos with small and large urls, amenities and bills already flattened into readable names.
Tenant and landlord personal data is never returned.
Combine a city, a budget range, a property type and a move-in date to collect matching listings with monthly prices, availability dates and photos.
Open Spotahome Search API docsPass the id, city and property type from a search result url to read availability ranges, stay rules, booking terms, amenities, bills and all photos.
Open Spotahome Listing API docsEverything you need in one API.
/api/spotahome/search
Search Spotahome rentals in a city with price, type and move-in filters and 48 listings per page
/api/spotahome/listing
Get the monthly price, availability, booking terms, amenities and photos of one listing
See how Scrappa compares to the official API.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| Spotahome listing data as JSON | Build your own parser | |
| Availability and stay rules | Parse it yourself | |
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
No. Scrappa is an independent service and is not affiliated with or endorsed by Spotahome. The Spotahome API returns structured JSON from public listing pages through a Scrappa API key.
Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan. Failed requests are never charged.
Use the 1-based page parameter. Every page holds up to 48 listings. The response returns total_results, total_pages, has_more and next_page. A page past the last page and a search without matches are successful empty responses.
No. An unknown city or listing answers a non-billable 404 with error code NOT_FOUND. Only successful 2xx responses are billed.