Sign in Get API key
Habitaclia API

Spanish Property Data — Listings, Details, Locations, and Agency Inventory

Search Habitaclia property listings across Spain, resolve a place name to the codes search needs, fetch full listing detail, and pull an agency's inventory by publisher id. Habitaclia is a large Spanish property portal with deep coverage in Catalonia and Valencia; Scrappa exposes its public listing data 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
Start for free View documentation
Browse endpoints Try first endpoint
4
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.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/habitaclia/search?transaction_type=buy&property_type=flat&code=46250&layer_id=20&page=1&page_size=5&sort_by=price_asc" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": [
    {
      "ad_id": "5f6a57a2-f588-47e8-8182-588957475340",
      "legacy_id": "i41124000089339",
      "url": "https://www.habitaclia.com/i41124000089339.htm",
      "property_type": "flat",
      "transaction_type": "buy",
      "price": 24600.0,
      "currency": "EUR",
      "rooms": 2,
      "bathrooms": 1,
      "built_surface": 76
    }
  ],
  "meta": { "endpoint_family": "search", "billable": true, "page": 1, "page_size": 5, "total_count": 3634, "has_more": true }
}

What you can build

Structured data for real applications. Here are some ideas.

Spanish Property Search

Build property search for Spain across flats, houses, offices, garages, buildings and land, for sale and rent, with price, rooms, bathrooms and feature filters.

Rental Market Analysis

Track sale and rent supply per municipality by combining the location endpoint's live counts with the listing totals, then follow how the market moves over time.

Agency Coverage Monitoring

Follow how much inventory a given agency publishes by querying its publisher id, then alert when the count changes between runs.

Listing Aggregation

Combine Habitaclia with Fotocasa, Idealista and other Spanish portals to build comparison tools. Deduplicate by ad id, address and coordinates to avoid double counting.

Available endpoints

Everything you need in one API.

GET

Search

/api/habitaclia/search

Search Habitaclia listings by transaction type, property type and place, with filters and pagination

Try in Playground View docs
GET

Listing Detail

/api/habitaclia/listing

Get the full detail record for one listing: description, address, media, energy certificate and price history

Try in Playground View docs

Scrappa vs Habitaclia (no public API)

See how Scrappa compares to the official API.

API available
Scrappa: Yes (4 endpoints)
Habitaclia (no public API): No public API
Property search
Scrappa: Programmatic
Habitaclia (no public API): Manual only
Property details
Scrappa: Structured JSON
Habitaclia (no public API): Not available
Location autocomplete
Scrappa:
Habitaclia (no public API): On-site only
Agency inventory
Scrappa:
Habitaclia (no public API): Manual only
Bulk access
Scrappa:
Habitaclia (no public API):
Free tier
Scrappa: 500 credits/month
Habitaclia (no public API): N/A
Integration ready
Scrappa: REST API
Habitaclia (no public API):

Key features

Every in-scope vertical: flats, houses, offices, garages, buildings and land
Sale and rent in one filter family
Full listing detail with description, address, media and energy certificate
Place autocomplete that returns the codes the search endpoint needs
Agency inventory by publisher id
Deep pagination with a consistent total count from the same response
An unknown listing id answers a clean, non-billable 404
No login, no browser and no kill switch — read-only public listing data
Structured JSON response format

Frequently asked questions

Habitaclia does not offer a public API. Scrappa provides 4 structured REST endpoints to search, resolve locations, fetch listing detail and pull agency inventory programmatically, without manual browsing.

Call the locations endpoint with the place name to get its code and layer id, then pass code and layer_id to the search endpoint. layer_id 20 is a municipality and 11 is a province.

From a listing. Every search and listing-detail item carries a publisher block with its id; pass that id to the publisher endpoint to pull the agency's inventory. There is no slug-to-id resolver.

Just a Scrappa API key passed as an X-API-KEY header. No Habitaclia account, no partner program, no OAuth. Sign up for free, get your key, and start querying property data immediately.

Yes. Every Scrappa account gets 500 free credits per month with no credit card required. Test all Habitaclia 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 Habitaclia endpoints cost the same. Failed requests are never billed.

Start using the Habitaclia API

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

Create Free Account View Documentation