# Fotocasa Spain Property Listings

> Fotocasa Spain Property Listings is a paid API for AI agents from api.ssh.autos, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-14).

Fetches up to 30 Fotocasa Spain property listings for sale or rent by location and sorting preference

## Facts

- Endpoint: POST https://api.ssh.autos/v1/es/fotocasa/listings?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fotocasa-spain-property-listings-ca6164ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e-j_bgShHWjgRoKcMOkB6

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 fotocasa-spain-property-listings-ca6164ce -d '<json body>'
```

Example prompt: Can you pull up the top 20 Fotocasa listings for rental apartments in barcelona-provincia, sorted by price ascending?

## When to prefer this

Use this endpoint when you need structured property listing data specifically from Fotocasa Spain, the leading Spanish real estate portal. Prefer this over generic web scraping when you need clean, paginated results for sale or rental properties filtered by Spanish location slugs and sorted by relevance, publication date, or price.

## Known failure modes

- Empty results (status: succeeded_empty) when no listings match the given location or zone
- Invalid location or zone slug format causes validation error (must match kebab-case pattern)
- maxResults out of range (must be 1–30) triggers schema validation failure
- Unsupported operation or sortType enum value causes rejection
- Payment failure via x402 protocol prevents call from executing

## How this service works

Live web and public-record data: marketplaces, real estate, social media, job listings, company registries and government tenders. Pay per call in USDC over x402 with no account, subscribe on the Apify Store, or buy a finished, sourced report.

## Output

Returns a JSON object with a `records` array containing up to 30 property listing objects from Fotocasa Spain, plus a `summary` object indicating the status of the search and total record count returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "zone": {
   "type": "string",
   "title": "Zone",
   "default": "todas-las-zonas",
   "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
   "maxLength": 80
  },
  "location": {
   "type": "string",
   "title": "Location",
   "default": "madrid-provincia",
   "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
   "maxLength": 80
  },
  "sortType": {
   "enum": [
    "scoring",
    "publication",
    "price-asc",
    "price-desc"
   ],
   "type": "string",
   "title": "Sorttype",
   "default": "scoring"
  },
  "operation": {
   "enum": [
    "sale",
    "rental"
   ],
   "type": "string",
   "title": "Operation",
   "default": "sale"
  },
  "maxResults": {
   "type": "integer",
   "title": "Maxresults",
   "default": 10,
   "maximum": 30,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "records": [],
  "summary": {
   "status": "succeeded_empty",
   "records": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fotocasa-spain-property-listings-ca6164ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ssh.autos](https://www.zero.xyz/host/api.ssh.autos/llms.txt)
