# Supercasa Price Report

Return Supercasa's price analysis for a business type, property type and locality: the price-per-m² series with its monthly, quarterly and yearly movement, the per-locality breakdown, and the raw numerics behind every formatted figure so a client can format them its own way. The underlying data is published by Infocasa and redistributed by Supercasa. While this family is withdrawn the endpoint answers 410 Gone with no upstream request and no charge; search, property, filters and autocomplete keep serving.

- **Documentation:** [https://scrappa.co/docs/supercasa-api/supercasa_price_report](https://scrappa.co/docs/supercasa-api/supercasa_price_report)
- **API group:** Supercasa API
- **Endpoint:** `GET https://scrappa.co/api/supercasa/price-report`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `business` | string | Yes | venda (sale) or arrendamento (rent). |
| `property_type` | string | Yes | Property type slug used in the report path, e.g. casas or apartamentos. |
| `location` | string | Yes | Locality slug, e.g. lisboa. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/supercasa/price-report?business=venda&property_type=casas&location=lisboa"
```

## Example response

```json
{
    "success": true,
    "business": "venda",
    "property_type": "casas",
    "location": "lisboa",
    "average_price_per_m2": "6.194 \u20ac",
    "min_price_per_m2": 4121,
    "max_price_per_m2": 6531,
    "data_points": 12,
    "locations": [
        {
            "name": "Lisboa",
            "priceRaw": 6193.9,
            "pricePerM2": "6.194 \u20ac/m\u00b2",
            "monthlyChangeRaw": -0.4
        }
    ]
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)