# Supercasa Map Search

Return the listings Supercasa holds inside a drawn map area, as markers with coordinates and prices. Each marker id resolves through the property endpoint, so a polygon result joins onto full listing records. The polygon is OGC Well-Known Text with longitude first. 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_map](https://scrappa.co/docs/supercasa-api/supercasa_map)
- **API group:** Supercasa API
- **Endpoint:** `GET https://scrappa.co/api/supercasa/map`

## 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 |
| --- | --- | --- | --- |
| `polygon` | string | Yes | WKT polygon in longitude-then-latitude order, e.g. POLYGON((-8.72 41.13,-8.65 41.13,-8.65 41.19,-8.72 41.19,-8.72 41.13)). |
| `zoom` | integer | No | Map zoom level for the request. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/supercasa/map?polygon=POLYGON%28%28-8.72+41.13%2C-8.65+41.13%2C-8.65+41.19%2C-8.72+41.19%2C-8.72+41.13%29%29&zoom=12"
```

## Example response

```json
{
    "success": true,
    "polygon": "POLYGON((-8.72 41.13,-8.65 41.13,-8.65 41.19,-8.72 41.19,-8.72 41.13))",
    "results_count": 3,
    "markers": [
        {
            "listing_id": 1978723,
            "latitude": 41.1231766,
            "longitude": -8.642253,
            "prices": [
                "785.000 \u20ac",
                ""
            ]
        }
    ]
}
```

## 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)