# Spitogatos Agent Properties API Documentation

<p><strong>Spitogatos Agent Properties API</strong> lists the current listings of one agency, rent and sale together, 30 per page. Each listing has the same fields as a search result. Failed requests are not billed.</p>

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

## 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 agency id from a listing (agency.id). |
| `page` | integer | No | One-based page number (default 1). 30 listings per page. |
| `locale` | string | No | Language of area names: el (default) or en. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": 21087988,
                "url": "https://www.spitogatos.gr/aggelia/2121087988",
                "floor": {
                    "code": 10,
                    "label": "Floor 5"
                },
                "image": "https://m2.spitogatos.gr/372704776_300x220.jpg?v=20130730",
                "price": 1900,
                "rooms": 4,
                "agency": {
                    "id": 20312,
                    "logo": "https://m2.spitogatos.gr/284965438_100x50.jpg",
                    "name": "TZELI HOME",
                    "slug": "TZELI-HOME",
                    "membership": "expert",
                    "profile_url": "https://www.spitogatos.gr/mesites/TZELI-HOME/20312"
                },
                "web_id": "2121087988",
                "ad_type": "vip",
                "area_m2": 148,
                "ad_types": [
                    "vip",
                    "prime"
                ],
                "category": "residential",
                "kitchens": 1,
                "modified": "2026-10-25 22:08:13",
                "uploaded": "2026-10-16 16:25:00",
                "bathrooms": 2,
                "geography": "\u0393\u03bf\u03c5\u03b4\u03ae (\u0396\u03c9\u03b3\u03c1\u03ac\u03c6\u03bf\u03c5)",
                "has_video": true,
                "image_ids": [
                    372704776,
                    372704784,
                    372704790
                ],
                "coordinates": {
                    "latitude": 37.982193,
                    "longitude": 23.770483,
                    "geocode_type": "offset"
                },
                "description": "\u00a0\n\u039a\u03c9\u03b4\u03b9\u03ba\u03cc\u03c2 \u0391\u03ba\u03b9\u03bd\u03ae\u03c4\u03bf\u03c5: #13685\n\u03a3\u03c4\u03b7\u03bd \u03c0\u03b5\u03c1\u03b9\u03bf\u03c7\u03ae \u03c4\u03bf\u03c5 \u0396\u03c9\u03b3\u03c1\u03ac\u03c6\u03bf\u03c5, \u03ba\u03bf\u03bd\u03c4\u03ac \u03c3\u03c4\u03b7\u03bd \u03a0\u03bf\u03bb\u03c5\u03c4\u03b5\u03c7\u03bd\u03b5\u03b9\u03bf\u03cd\u03c0\u03bf\u03bb\u03b7, \u03b4\u03b9\u03b1\u03c4\u03af\u03b8\u03b5\u03c4\u03b1\u03b9 \u03c0\u03c1\u03bf\u03c2 \u03b5\u03bd\u03bf\u03b9\u03ba\u03af\u03b1\u03c3\u03b7 \u03ad\u03bd\u03b1 \u03b5\u03c5\u03c1\u03cd\u03c7\u03c9\u03c1\u03bf, \u03b4\u03b9\u03b1\u03bc\u03c0\u03b5\u03c1\u03ad\u03c2 \u03ba\u03b1\u03b9 \u03bc\u03b5\u03c1\u03b9\u03ba\u03ce\u03c2 \u03b1\u03bd\u03b1\u03ba\u03b1\u03b9\u03bd\u03b9\u03c3\u03bc\u03ad\u03bd\u03bf \u03b4\u03b9\u03b1\u03bc\u03ad\u03c1\u03b9\u03c3\u03bc\u03b1 148\u03c4.\u03bc., \u03c3\u03c4\u03bf\u03bd 5\u03bf \u03cc\u03c1\u03bf\u03c6\u03bf \u03c0\u03bf\u03bb\u03c5\u03ba\u03b1\u03c4\u03bf\u03b9\u03ba\u03af\u03b1\u03c2 \u03bc\u03b5 \u03b1\u03c3\u03b1\u03bd\u03c3\u03ad\u03c1. \u03a4...",
                "listing_type": "rent",
                "living_rooms": 1,
                "price_per_m2": 12.84,
                "price_reduced": false,
                "property_type": "apartment",
                "new_development": false,
                "has_virtual_tour": false,
                "first_publish_date": "2026-10-16 16:25:00",
                "price_pre_reduction": null,
                "price_change_percentage": null
            }
        ],
        "agent_id": 20312,
        "pagination": {
            "page": 1,
            "total": 982,
            "per_page": 30,
            "last_page": 33,
            "has_next_page": true
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agent_properties"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. 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)