# Spitogatos Property API Documentation

<p><strong>Spitogatos Property API</strong> returns one listing: price and price per square meter, sizes, rooms, bathrooms, floor, year built, energy class, heating, a feature list, the full description, address and area tree, coordinates, all photos in three sizes, video and virtual tour links, the listing URLs, and the publishing agency with business phones. Use the <code>id</code> from a search result. A listing from a private person returns no publisher. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/spitogatos-api/spitogatos_property](https://scrappa.co/docs/spitogatos-api/spitogatos_property)
- **API group:** Spitogatos API
- **Endpoint:** `GET https://scrappa.co/api/spitogatos/property`

## 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 |
| --- | --- | --- | --- |
| `id` | integer | Yes | The listing id from a search result (the id field). |
| `locale` | string | No | Language of area names: el (default) or en. |

## Example response

```json
{
    "data": {
        "id": 21020078,
        "wc": null,
        "url": "https://www.spitogatos.gr/aggelia/2121020078",
        "urls": {
            "el": "https://www.spitogatos.gr/aggelia/2121020078",
            "en": "https://www.spitogatos.gr/en/property/2121020078"
        },
        "floor": {
            "code": 3,
            "label": "Ground floor"
        },
        "price": 630,
        "rooms": 1,
        "agency": {
            "id": 20312,
            "area": "\u039a\u03b1\u03b9\u03c3\u03b1\u03c1\u03b9\u03b1\u03bd\u03ae (\u0391\u03b8\u03ae\u03bd\u03b1 - \u039d\u03cc\u03c4\u03b9\u03b1 \u03a0\u03c1\u03bf\u03ac\u03c3\u03c4\u03b9\u03b1)",
            "logo": "https://m2.spitogatos.gr/284965438_200x100.jpg?v=20130730",
            "name": "TZELI HOME",
            "slug": "TZELI-HOME",
            "phones": [
                "+302110014573",
                "+306906062919"
            ],
            "address": "\u03a5\u03bc\u03b7\u03c4\u03c4\u03bf\u03cd, 41, \u039a\u03b1\u03b9\u03c3\u03b1\u03c1\u03b9\u03b1\u03bd\u03ae \u0395\u03bb\u03bb\u03ac\u03b4\u03b1, 16121",
            "website": "https://tzelihome.gr/",
            "membership": "expert",
            "description": null,
            "profile_url": "https://www.spitogatos.gr/mesites/TZELI-HOME/20312",
            "is_developer": false
        },
        "images": [
            {
                "id": 371564395,
                "large": "https://m2.spitogatos.gr/371564395_900x675.jpg?v=20130730",
                "order": 1,
                "medium": "https://m2.spitogatos.gr/371564395_300x220.jpg?v=20130730",
                "xlarge": "https://m2.spitogatos.gr/371564395_1600x1200.jpg?v=20130730",
                "description": "\u0386\u03c0\u03bf\u03c8\u03b7 \u03c7\u03ce\u03c1\u03bf\u03c5"
            },
            {
                "id": 371564398,
                "large": "https://m2.spitogatos.gr/371564398_900x675.jpg?v=20130730",
                "order": 2,
                "medium": "https://m2.spitogatos.gr/371564398_300x220.jpg?v=20130730",
                "xlarge": "https://m2.spitogatos.gr/371564398_1600x1200.jpg?v=20130730",
                "description": "\u0386\u03c0\u03bf\u03c8\u03b7 \u03c7\u03ce\u03c1\u03bf\u03c5"
            }
        ],
        "levels": 1,
        "web_id": "2121020078",
        "ad_type": "vip",
        "address": {
            "areas": [
                {
                    "id": 100,
                    "name": "\u0391\u03b8\u03ae\u03bd\u03b1 - \u039a\u03ad\u03bd\u03c4\u03c1\u03bf",
                    "slug": null,
                    "level": 2,
                    "latitude": 37.9894707207,
                    "full_name": "\u0391\u03b8\u03ae\u03bd\u03b1 - \u039a\u03ad\u03bd\u03c4\u03c1\u03bf (\u0391\u03c4\u03c4\u03b9\u03ba\u03ae)",
                    "longitude": 23.7344219707
                },
                {
                    "id": 2025,
                    "name": "\u039b\u03b5\u03c9\u03c6\u03cc\u03c1\u03bf\u03c2 \u03a0\u03b1\u03c4\u03b7\u03c3\u03af\u03c9\u03bd - \u039b\u03b5\u03c9\u03c6\u03cc\u03c1\u03bf\u03c2 \u0391\u03c7\u03b1\u03c1\u03bd\u03ce\u03bd",
                    "slug": null,
                    "level": 4,
                    "latitude": 38.0062822279,
                    "full_name": "\u039b\u03b5\u03c9\u03c6\u03cc\u03c1\u03bf\u03c2 \u03a0\u03b1\u03c4\u03b7\u03c3\u03af\u03c9\u03bd - \u039b\u03b5\u03c9\u03c6\u03cc\u03c1\u03bf\u03c2 \u0391\u03c7\u03b1\u03c1\u03bd\u03ce\u03bd (\u0391\u03b8\u03ae\u03bd\u03b1 - \u039a\u03ad\u03bd\u03c4\u03c1\u03bf)",
                    "longitude": 23.7280079888
                }
            ],
            "street": null,
            "coordinates": {
                "latitude": 38.000046,
                "longitude": 23.73131,
                "geocode_type": "offset"
            },
            "geography_id": 2043
        },
        "area_m2": 60,
        "heating": {
            "fuel": {
                "code": 4,
                "label": "Electricity"
            },
            "system": {
                "code": 1,
                "label": "Autonomous"
            }
        },
        "my_code": "13562",
        "category": "residential",
        "features": [
            {
                "key": "AC",
                "label": "Air conditioning"
            },
            {
                "key": "petsAllowed",
                "label": "Pets allowed"
            },
            {
                "key": "secure_door",
                "label": "Security door"
            }
        ],
        "kitchens": 1,
        "modified": "2026-10-25",
        "uploaded": "2026-10-07",
        "bathrooms": 1,
        "publisher": {
            "logo": "https://m2.spitogatos.gr/284965438_200x100.jpg?v=20130730",
            "name": "TZELI HOME",
            "phones": [
                "+302110014573",
                "+306906062919"
            ],
            "website": "https://tzelihome.gr/",
            "agent_id": 20312,
            "profile_url": "https://www.spitogatos.gr/mesites/TZELI-HOME/20312",
            "is_developer": false
        },
        "year_built": 1967,
        "breadcrumbs": [
            {
                "url": "https://www.spitogatos.gr/rent",
                "label": "\u0395\u03bd\u03bf\u03b9\u03ba\u03b9\u03ac\u03c3\u03b5\u03b9\u03c2 \u03ba\u03b1\u03c4\u03bf\u03b9\u03ba\u03b9\u03ce\u03bd"
            },
            {
                "url": "https://www.spitogatos.gr/enoikiaseis-katoikies/athina-kentro",
                "label": "\u0391\u03b8\u03ae\u03bd\u03b1 - \u039a\u03ad\u03bd\u03c4\u03c1\u03bf"
            }
        ],
        "description": "\u00a0\u039a\u03c9\u03b4\u03b9\u03ba\u03cc\u03c2 \u0391\u03ba\u03b9\u03bd\u03ae\u03c4\u03bf\u03c5: #13562 \u039b\u03b5\u03c9\u03c6. \u03a0\u03b1\u03c4\u03b7\u03c3\u03af\u03c9\u03bd - \u039b\u03b5\u03c9\u03c6. \u0391\u03c7\u03b1\u03c1\u03bd\u03ce\u03bd, \u0391\u03b3. \u039c\u03b5\u03bb\u03b5\u03c4\u03af\u03bf\u03c5 - \u03a0\u03bb. \u0392\u03b9\u03ba\u03c4\u03c9\u03c1\u03af\u03b1\u03c2 - \u039c\u03ac\u03c1\u03bd\u03b7: \u0395\u03bd\u03bf\u03b9\u03ba\u03b9\u03ac\u03b6\u03b5\u03c4\u03b1\u03b9 \u03c0\u03bb\u03ae\u03c1\u03c9\u03c2 \u03b1\u03bd\u03b1\u03ba\u03b1\u03b9\u03bd\u03b9\u03c3\u03bc\u03ad\u03bd\u03bf \u0394\u03b9\u03b1\u03bc\u03ad\u03c1\u03b9\u03c3\u03bc\u03b1 60\u03c4.\u03bc. \u03c3\u03b5 \u03b9\u03c3\u03cc\u03b3\u03b5\u03b9\u03bf . \u0391\u03c0\u03bf\u03c4\u03b5\u03bb\u03b5\u03af\u03c4\u03b1\u03b9 \u03b1\u03c0\u03cc 1 \u03c5\u03c0\u03bd\u03bf\u03b4\u03c9\u03bc\u03ac\u03c4\u03b9\u03bf, 1 \u03ba\u03bf\u03c5\u03b6\u03af\u03bd\u03b1, 1 \u03c3\u03b1\u03bb\u03cc\u03bd\u03b9, \u03ba\u03b1\u03b9 \u03bc\u03c0\u03ac...",
        "net_area_m2": null,
        "energy_class": {
            "code": 6,
            "label": "\u0394"
        },
        "listing_type": "rent",
        "living_rooms": 1,
        "plot_area_m2": null,
        "price_per_m2": 10.5,
        "gross_area_m2": null,
        "property_type": "apartment",
        "available_from": "2026-10-07",
        "price_includes": [],
        "common_expenses": null,
        "renovation_year": 2026,
        "negotiable_price": false,
        "video_youtube_id": "neBet5mpDp0",
        "virtual_tour_url": null,
        "distance_to_sea_m": 9000,
        "first_publish_date": "2026-10-07"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "property"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. This response is not billable. |
| 404 | Not Found | The listing does not exist or was removed. This response is not billable. |
| 503 | Upstream Unavailable | Spitogatos could not be reached or returned data that does not match the request. This response is not billable and is retryable. |

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