# Casa Sapo Ad

## Overview

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

## Description

Retrieve a full Casa Sapo property listing by URL with price, area, rooms, amenities, coordinates, 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/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### T3 apartment listing in Benfica, Lisboa

```json
{
  "id": "cs-PT92037481",
  "url": "https://casa.sapo.pt/comprar/apartamentos/lisboa/benfica/pt92037481.html",
  "area": {
    "land_m2": null,
    "total_m2": 91.4,
    "useful_m2": 86.7
  },
  "price": {
    "amount": 349000,
    "currency": "EUR",
    "negotiable": false,
    "price_per_m2": 4026,
    "condominium_fee": 85
  },
  "title": "Apartamento T3 em Benfica, Lisboa",
  "images": [
    "https://static.cdn-casa-sapo.pt/photos/pt92037481/1/1024x768.jpg",
    "https://static.cdn-casa-sapo.pt/photos/pt92037481/2/1024x768.jpg",
    "https://static.cdn-casa-sapo.pt/photos/pt92037481/3/1024x768.jpg",
    "https://static.cdn-casa-sapo.pt/photos/pt92037481/4/1024x768.jpg"
  ],
  "status": "active",
  "features": {
    "floor": 2,
    "rooms": 5,
    "bedrooms": 3,
    "elevator": true,
    "bathrooms": 2,
    "condition": "like_new",
    "total_floors": 5,
    "construction_year": 1985,
    "energy_certificate": "C"
  },
  "location": {
    "city": "Lisboa",
    "parish": "Benfica",
    "district": "Lisboa",
    "latitude": 38.7467,
    "longitude": -9.1913,
    "full_address": null
  },
  "typology": "T3",
  "amenities": [
    "Garagem",
    "Varanda",
    "Arrecadação",
    "Elevador",
    "Ar condicionado"
  ],
  "operation": "sale",
  "publisher": {
    "name": "Keller Williams Lisboa Oeste",
    "type": "agency",
    "phone": "+351 21 311 4000",
    "license": "AMI 15753",
    "website": "https://www.kwportugal.pt"
  },
  "reference": "KW-LX-00182374",
  "thumbnail": "https://static.cdn-casa-sapo.pt/photos/pt92037481/1/320x240.jpg",
  "updated_at": "2026-05-01T11:30:00.000Z",
  "description": "Excelente apartamento T3 situado na Rua Padre Cruz, em Benfica. O imóvel tem 86 m² de área útil e foi totalmente remodelado em 2021. Dispõe de sala de estar com varanda, cozinha equipada de planta aberta, três quartos com roupeiros embutidos e duas casas de banho. Garagem e arrecadação incluídas. Edifício com elevador.",
  "published_at": "2026-04-28T09:00:00.000Z",
  "property_type": "apartment",
  "virtual_tour_url": null
}
```

## Documentation

## Overview

Casa Sapo is one of Portugal's major real estate portals (SAPO/Altice group). Each listing page holds price, area, typology, floor, energy certificate, amenities, coordinates, images, and the agent's AMI license. The platform applies Cloudflare protection. Piloterr handles the bypass and returns the full listing as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/casa-sapo/ad?url=https://casa.sapo.pt/comprar/apartamentos/lisboa/benfica/pt92037481.html
```

## Main use cases

- Pull full listing data to build a CRM enrichment pipeline for Portuguese real estate agencies
- Collect price, area, and coordinates to train a property price prediction model for Portugal
- Monitor listing URLs for price reductions or status changes to trigger buyer and investor alerts
- Compare Casa Sapo details against Imovirtual for the same property to detect price discrepancies
- Aggregate energy certificates and construction years across Lisbon parishes for renovation opportunity mapping