# Casa Sapo Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/casa-sapo/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/casa-sapo-search |

## Description

Search Casa Sapo Portugal property listings by location and get price, rooms, area, features, and publisher data as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/casa-sapo/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Apartments for sale in Lisboa

```json
{
  "page": 1,
  "results": [
    {
      "id": "cs-PT92037481",
      "url": "https://casa.sapo.pt/comprar/apartamentos/lisboa/benfica/pt92037481.html",
      "price": 349000,
      "title": "Apartamento T3 em Benfica, Lisboa",
      "area_m2": 86.7,
      "location": {
        "city": "Lisboa",
        "parish": "Benfica",
        "district": "Lisboa"
      },
      "typology": "T3",
      "operation": "sale",
      "thumbnail": "https://static.cdn-casa-sapo.pt/photos/pt92037481/1/320x240.jpg",
      "highlights": [
        "Garagem",
        "Varanda",
        "Arrecadação"
      ],
      "price_per_m2": 4026,
      "published_at": "2026-04-28T09:00:00.000Z",
      "property_type": "apartment",
      "publisher_name": "Keller Williams Lisboa Oeste"
    },
    {
      "id": "cs-PT92019273",
      "url": "https://casa.sapo.pt/comprar/moradias/lisboa/cascais/cascais-centro/pt92019273.html",
      "price": 895000,
      "title": "Moradia T4 em Cascais, Lisboa",
      "area_m2": 165.5,
      "location": {
        "city": "Cascais",
        "parish": "Cascais e Estoril",
        "district": "Lisboa"
      },
      "typology": "T4",
      "operation": "sale",
      "thumbnail": "https://static.cdn-casa-sapo.pt/photos/pt92019273/1/320x240.jpg",
      "highlights": [
        "Piscina",
        "Garagem",
        "Jardim",
        "Terraço"
      ],
      "price_per_m2": 5408,
      "published_at": "2026-04-22T16:45:00.000Z",
      "property_type": "house",
      "publisher_name": "Remax Cascais"
    }
  ],
  "total_results": 5384,
  "results_per_page": 25
}
```

## Documentation

## Overview

Casa Sapo is one of Portugal's major real estate portals (SAPO/Altice group) with 80k+ active listings. It covers sale and rental markets for apartments, houses, land, and commercial spaces. The platform applies Cloudflare protection. Piloterr handles the bypass and returns paginated listings as structured JSON.

Each result includes price, price per m², area, typology (T0–T6+), parish, highlights (pool, garage, etc.), publication date, and publisher name.

## Quickstart

```
GET https://api.piloterr.com/v2/casa-sapo/search?location=Lisboa&operation=sale&property_type=apartment
```

## Main use cases

- Track price per m² trends across Portuguese parishes for a domestic property valuation model
- Monitor new listings to surface investment opportunities as soon as they go live
- Benchmark Casa Sapo prices against Imovirtual by location and typology to detect pricing gaps
- Build a rental affordability index by aggregating rental prices across Portuguese cities
- Feed a lead generation engine for real estate agencies with daily new listing data