Spotahome API

Spotahome API for Mid and Long-Term Rental Search and Listing Details

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.

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
2
Endpoints
48
Listings per page
$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/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"
JSON response
{
  "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
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Rental Price Monitoring

Track monthly asking prices for rooms, studios and apartments in Madrid, Berlin, Paris, Milan and more, filtered by budget and property type.

Relocation and Housing Tools

Search furnished rentals by city and move-in date and show real availability, minimum stay and photos inside your relocation product.

Availability Tracking

Read available, unavailable and move-in date ranges plus minimum and maximum stay for any listing to detect when a place opens up.

Market Research

Compare supply, price ranges and bills included across European cities with the total result counts returned by every search.

Listing Enrichment

Add amenities, house rules, deposit terms and landlord type to a rental database from a single listing request.

Spotahome scraper API

Spotahome API for monthly rental listings, prices, and availability

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.

Choose the right Spotahome API endpoint

Use Rental Search for market coverage

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 docs

Use Listing Details for the full record

Pass 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 docs

Available endpoints

Everything you need in one API.

GET

Rental Search

/api/spotahome/search

Search Spotahome rentals in a city with price, type and move-in filters and 48 listings per page

GET

Listing Details

/api/spotahome/listing

Get the monthly price, availability, booking terms, amenities and photos of one listing

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

Spotahome listing data as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Availability and stay rules
Scrappa:
ScrapingBee / ScraperAPI: Parse it yourself
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits

Key features

Rental search by city with budget, property type and move-in date filters
Monthly price as an integer with currency, plus max_price for listings with a price range
Availability, minimum and maximum stay and date ranges per listing
Deposit and admin fee terms exactly as Spotahome reports them
Amenities and bills flattened into readable names, photos with small and large urls
Tenant and landlord personal data is never returned

Frequently asked questions

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.

Start using the Spotahome API

Sign up and get 500 free credits. No credit card required.