{
    "openapi": "3.1.0",
    "info": {
        "title": "Zazidljiva.si API",
        "version": "1.0.0",
        "description": "Cene zazidljivih zemljišč v Sloveniji iz Evidence trga nepremičnin (GURS) ter javni oglasi in povpraševanja. Samo branje, brez prijave. Pri navajanju cen navedite vir (GURS, Evidenca trga nepremičnin), obdobje in da gre za pregled trga, ne cenitev parcele. MCP: https://zazidljiva.si/wp-json/zaz/v1/mcp"
    },
    "servers": [
        {
            "url": "https://zazidljiva.si/wp-json/zaz/v1"
        }
    ],
    "paths": {
        "/land-price": {
            "get": {
                "operationId": "getLandPrice",
                "summary": "Cena zazidljivih zemljišč v kraju: mediana, razpon, po tipu, po letih, trend, primerjava s Slovenijo; za kraje s stranjo še location_ratings (poplave, potresi, pogrezanje tal, veter, sneg, osončenost, 1–5).",
                "parameters": [
                    {
                        "name": "place",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Občina, katastrska občina ali kraj, npr. Kranj, Črnuče.",
                        "example": "Kranj"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Uspeh",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kraja ali podatkov ni",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/land-compare": {
            "get": {
                "operationId": "compareLandPrices",
                "summary": "Primerjava 2–10 krajev, od najcenejšega.",
                "parameters": [
                    {
                        "name": "places",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Kraji, ločeni z vejico.",
                        "example": "Kranj,Bled,Komenda"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Uspeh",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kraja ali podatkov ni",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/land-deals": {
            "get": {
                "operationId": "getRecentLandDeals",
                "summary": "Zadnje zabeležene prodaje v kraju.",
                "parameters": [
                    {
                        "name": "place",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Občina, katastrska občina ali kraj, npr. Kranj, Črnuče.",
                        "example": "Kranj"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 50,
                            "default": 20
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Uspeh",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kraja ali podatkov ni",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/land-rank": {
            "get": {
                "operationId": "rankMunicipalities",
                "summary": "Lestvica občin po ceni ali številu prodaj.",
                "parameters": [
                    {
                        "name": "order",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "cheapest",
                                "most_expensive",
                                "most_deals"
                            ],
                            "default": "cheapest"
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 50,
                            "default": 10
                        }
                    },
                    {
                        "name": "max_price",
                        "in": "query",
                        "schema": {
                            "type": "number",
                            "minimum": 0
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Uspeh",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kraja ali podatkov ni",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/land-prices": {
            "get": {
                "operationId": "listMunicipalityPrices",
                "summary": "Cene za vse občine (mediana, kvartili, povprečje, prodaje, delež).",
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "Uspeh",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kraja ali podatkov ni",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/search": {
            "get": {
                "operationId": "searchEntries",
                "summary": "Javni oglasi in povpraševanja za zazidljive parcele.",
                "parameters": [
                    {
                        "name": "place",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "intent",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "buy",
                                "sell"
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Uspeh",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Kraja ali podatkov ni",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}