# Habitaclia Property Listings Scraper

> Habitaclia Property Listings Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured real estate listing data from Habitaclia, a Spanish property portal, with filters for price, area, rooms, and property type

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/habitaclia?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/habitaclia-property-listings-scraper-ab0459ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uwZ-AvrpQYtdoyIols9I4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability habitaclia-property-listings-scraper-ab0459ec -d '<json body>'
```

Example prompt: Search Habitaclia for 2-bedroom apartments for rent in Barcelona priced between 800 and 1500 EUR, at least 60 sqm, sorted by newest, and return up to 50 listings from private sellers only.

## When to prefer this

Use this endpoint when you need structured property listing data specifically from Habitaclia, the leading Spanish-language real estate portal focused on Spain and particularly Catalonia. Prefer it over generic web scrapers when you need built-in filters for price, area, rooms, property type, and advertiser type without post-processing. Ideal for agents researching Spanish property markets, building rental/sale comparison tools, or monitoring listing availability in Spanish cities.

## Known failure modes

- No listings found matching filters — returns empty items array, no charge
- Invalid location string not recognized by Habitaclia — may return empty results
- startUrls pointing to expired or removed listings — returns partial or empty data
- maxPages or maxListings limits reached before full dataset is collected
- Habitaclia site structure changes breaking scraper — may return malformed or empty data
- Network timeout or site unavailability — request fails with error response

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of matched listings and an array of items, each with fields including ad ID, title, detail URL, description, property type, property subtype, transaction type, and real estate ad ID. Only populated listings are returned; failed or empty runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "price_asc",
    "price_desc",
    "newest",
    "price_drop"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Ordering used by the site for search results."
  },
  "keyword": {
   "type": "string",
   "description": "Keep listings whose title or description contains this text, without accent sensitivity."
  },
  "maxArea": {
   "type": "integer",
   "minimum": 0,
   "description": "Keep listings with at most this built area in square metres."
  },
  "minArea": {
   "type": "integer",
   "minimum": 0,
   "description": "Keep listings with at least this built area in square metres."
  },
  "location": {
   "type": "string",
   "default": "barcelona",
   "description": "Province capital or province name. For districts or other towns, paste a search URL."
  },
  "maxPages": {
   "type": "integer",
   "default": 20,
   "minimum": 1,
   "description": "Read at most this many search pages per URL. Each page has about 30 listings."
  },
  "maxPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Keep listings priced at or below this amount in EUR."
  },
  "maxRooms": {
   "type": "integer",
   "minimum": 0,
   "description": "Keep listings with at most this many rooms."
  },
  "minPrice": {
   "type": "integer",
   "minimum": 0,
   "description": "Keep listings priced at or above this amount in EUR."
  },
  "minRooms": {
   "type": "integer",
   "minimum": 0,
   "description": "Keep listings with at least this many rooms."
  },
  "startUrls": {
   "type": "array",
   "description": "Optional current search URLs or newer individual listing URLs. Overrides transaction, property type and location."
  },
  "maxListings": {
   "type": "integer",
   "default": 200,
   "minimum": 1,
   "description": "Stop after this many dataset items across all URLs."
  },
  "propertyType": {
   "enum": [
    "any",
    "apartment",
    "house",
    "attic",
    "office",
    "commercial",
    "land",
    "parking"
   ],
   "type": "string",
   "default": "any",
   "description": "Choose a listing category on the search page."
  },
  "advertiserType": {
   "enum": [
    "all",
    "agency",
    "private"
   ],
   "type": "string",
   "default": "all",
   "description": "Filter by agency or private listing when identified by the page."
  },
  "transactionType": {
   "enum": [
    "sale",
    "rent"
   ],
   "type": "string",
   "default": "sale",
   "description": "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "adId": null,
    "title": null,
    "detailUrl": null,
    "description": null,
    "propertyType": null,
    "realEstateAdId": null,
    "propertySubtype": null,
    "transactionType": null
   }
  ],
  "product": "habitaclia"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/habitaclia-property-listings-scraper-ab0459ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)
