Skip to content

Full Search By Attribute

POST /comparables/fullSearchByAttribute

Search for comparable listings based on filters linked to the descriptive variables of the comparable. Returns the detail output for each comparable.

Example Request

curl -X POST --location 'https://comparables-gr.realitycs.it/comparables/fullSearchByAttribute' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Filters": {
        "comparableTypeID": [
            1
        ],
        "pubblicationStatusID": [
            1,
            2
        ],
        "contractTypeID": 1,
        "lat": 37.963626407474564,
        "lng": 23.730869071451338,
        "municipalityID": "124221",
        "marketParentZoneID": "4054",
        "include_uuid": [
            "964b954d-9d87-4001-a64e-566a1c0fa500"
        ]
    },
    "Pagination": {
        "page": 1,
        "limit": 2
    },
    "Sorting": {
        "by": "date",
        "direction": "desc"
    }
}'

Example Response

{
    "_metadata": {
        "limit": 2,
        "page": 1,
        "pages": {
            "first": 1,
            "last": 1,
            "next": null,
            "previous": null,
            "self": 1
        },
        "query": {
            "comparableType": "Listings",
            "contractType": "Sale",
            "include_uuid": [
                "964b954d-9d87-4001-a64e-566a1c0fa500"
            ],
            "lat": 37.963626407474564,
            "lng": 23.730869071451338,
            "marketParentZoneID": "4054",
            "municipalityID": "124221",
            "pubblicationStatus": [
                "New",
                "Published"
            ],
            "sorting": {
                "by": "date",
                "direction": "desc"
            }
        },
        "total_count": 1,
        "request_id": "790f37b5-2d40-4d1f-b485-fb217e628a74"
    },
    "items": [
        {
            "_metadata": [
                "comparabili_centralitybelt_?",
                "comparabili_heatingsystem_?",
                "comparabili_maintenancestatus_?",
                "comparabili_occupancystatus_2",
                "comparabili_propertyquality_?",
                "comparabili_pubblicationstatus_2",
                "comparabili_comparabletype_1",
                "comparabili_propertytype_104",
                "comparabili_gardentype_1",
                "comparabili_energyclass_5"
            ],
            "agencyID": null,
            "attachments": {
                "coverImage": "https://m2.spitogatos.gr/221807639_1600x1200.jpg",
                "energyClass": null,
                "image": [
                    "https://media.indomio.gr/image/12975495/m-c.jpg",
                    "https://media.indomio.gr/image/12975537/m-c.jpg",
                    "https://media.indomio.gr/image/12975585/m-c.jpg",
                    "https://media.indomio.gr/image/12975629/m-c.jpg",
                    "https://media.indomio.gr/image/12975679/m-c.jpg",
                    "https://media.indomio.gr/image/12975731/m-c.jpg",
                    "https://media.indomio.gr/image/12975785/m-c.jpg",
                    "https://media.indomio.gr/image/12975823/m-c.jpg",
                    "https://media.indomio.gr/image/12975869/m-c.jpg",
                    "https://media.indomio.gr/image/12975919/m-c.jpg",
                    "https://media.indomio.gr/image/12975965/m-c.jpg",
                    "https://media.indomio.gr/image/12976009/m-c.jpg",
                    "https://media.indomio.gr/image/12976047/m-c.jpg",
                    "https://media.indomio.gr/image/12976093/m-c.jpg",
                    "https://media.indomio.gr/image/12976137/m-c.jpg",
                    "https://media.indomio.gr/image/12976181/m-c.jpg"
                ],
                "layout": null
            },
            "buyedNow": null,
            "cadastralData": [
                {
                    "cadastralClass": null,
                    "cadastralCompartments": null,
                    "cadastralIncome": null,
                    "cadastralMapSheetNumber": null,
                    "cadastralMunicipality": null,
                    "cadastralParceSubParcelNumber": null,
                    "cadastralParcelNumber": null,
                    "cadastralPmCode": null,
                    "cadastralPropertyType": null,
                    "cadastralRegistry": null,
                    "cadastralSectionCode": null
                }
            ],
            "clientType": "Professional",
            "collectionDate": "2021-10-29T00:00:00Z",
            "comparableType": "Listings",
            "dataOwnership": "realitycs",
            "distanceFromPoi": "221116",
            "duplicates": false,
            "duplicatesParent": false,
            "extra": {
                "condoFees": null,
                "lastCommercialUse": null,
                "showCases": null,
                "showCasesSize": null,
                "title": null
            },
            "features": {
                "box": "true",
                "brightness": null,
                "centralityBelt": "",
                "constructionYear": 0,
                "contructionYearNote": null,
                "description": "ΚΑΡΦΑΣ-ΧΙΟΣ\nΠΡΩΣ ΠΩΛΗΣΗ  ΣΤΟ ΚΑΡΦΑ ΜΕΖΟΝΕΤΑ 150 ΤΜ. ΥΠΟ ΚΑΤΑΣΚΕΥΗ ΣΕ ΟΙΚΟΠΕΔΟ 1300Μ.ΔΙΑΘΕΤΕΙ  ΕΠΙΠΛΕΟΝ ΔΙΑΜΕΡΙΣΜΑ 50 ΤΜ. ΣΤΟ ΙΣΟΓΕΙΟ ΚΑΙ 100 ΤΜ. ΚΛΕΙΣΤΟ ΓΚΑΡΑΖ.ΓΙΑ ΠΕΡΙΣΣΟΤΕΡΕΣ ΠΛΗΡΟΦΟΡΙΕΣ ΚΑΛΕΣΤΕ ΣΤΟ 2271100767 Η ΣΤΟ 6949742665 Η ΜΕΣΩ MAIL ΣΤΟ chioshome21@gmail.com.ΚΩΔ(Σ0084)",
                "elevator": null,
                "energyClass": "C",
                "exposure": null,
                "facilityList": [],
                "fitnessForPurpose": null,
                "gardenType": "Comune",
                "heatingSystem": null,
                "maintenanceStatus": null,
                "numberOfBalconies": null,
                "numberOfBathrooms": 2,
                "numberOfBuildingFloor": 2,
                "numberOfGarages": 1,
                "occupancyStatus": "Occupied - Investment property",
                "propertyQuality": null,
                "qualityOfFinishes": null,
                "unitFloor": null,
                "viewQuality": null
            },
            "grossSquareFootage": 150,
            "lastUpdateDate": "2024-05-10T00:00:00Z",
            "lastUpdateDateV2": null,
            "listingUrl": "https://www.spitogatos.gr/aggelia/1111768394",
            "location": {
                "address": "Άγιος Μηνάς",
                "district": null,
                "latitude": 38.321205,
                "longitude": 26.15246,
                "marketParentZone": "4054",
                "marketZone": null,
                "municipality": "Chios",
                "municipalityID": 124221,
                "province": "Chios Prefecture",
                "region": "Aegean Islands",
                "streetNumber": null,
                "zipCode": null
            },
            "marketData": {
                "askingReductionRate": null,
                "askingReductionSteps": null,
                "municipalityVisibilityIndex": null,
                "quarterMacroareaTrend": null,
                "quarterMicroareaTrend": null,
                "quarterMunicipalityTrend": null,
                "semesterMacroareaTrend": null,
                "semesterMicroareaTrend": null,
                "semesterMunicipalityTrend": null,
                "timeOnTheMarket": 30,
                "zonalVisibilityIndex": null
            },
            "previouslyBuyed": null,
            "propertyType": "detached",
            "pubblicationStatus": "Published",
            "realEstateRegisters": {
                "deedDate": null,
                "deedType": null,
                "folder": null,
                "generalNumber": null,
                "inventory": null,
                "notary": null,
                "particularNumber": null,
                "pdfFileUrl": null,
                "propertyRegistryId": null
            },
            "rooms": 0,
            "sourceName": "indomio.gr",
            "unitGrossSquareFootage": [],
            "uuid": "964b954d-9d87-4001-a64e-566a1c0fa500",
            "value": {
                "askingPrice": 180000,
                "askingPricePsm": 1200,
                "discount": null,
                "price": null,
                "pricePsm": null,
                "value": null,
                "valuePsm": null
            }
        }
    ]
}

Request Fields

Required column Meaning
* mandatory in the input
** at least one of these parameters is mandatory in the input

Request fields

Field Required Type Example Notes
marketParentZoneID ** string 103489
municipalityID ** string 15146
boundingBox ** geojson {"type": "Polygon","coordinates": [...]}
contractTypeID * int 1 depends on comparableTypeID
propertyTypeID int 4
categoryTypeID int 2
propertyQualityID int 3
minGrossSquareFootage int 50
maxGrossSquareFootage int 120
minRooms int 1
maxRooms int 2
minPrice int 1200000
maxPrice int 2500000
minPricePsm int 2000
maxPricePsm int 5000
minBathrooms int 1
maxBathrooms int 3
maintenanceStatusID int 2
pubblicationStatusID int 4
unitFloor float 1
elevator bool true
garage bool false
minDate string 12/01/2025
maxDate string 25/09/2025
clientTypeID int 2
phoneNumberProvided bool false
lat float '45.4775832' relative to a POI, used to calculate distance
lng float '9.1858904' relative to a POI, used to calculate distance
minDeletionDate string 12/01/2025
maxDeletionDate string 25/09/2025
minModifiedDate string 12/01/2025
maxModifiedDate string 25/09/2025
energyClassID int 15
minConstructionYear string 1950
maxConstructionYear string 2025
duplicatesFilterID int 2

Pagination example usage

{
   "Filters": {
       ... filters ...
    },
"Pagination": {
    "page": 1,
    "limit": 10
    }
}
N.B. The pagination object can be omitted from the json body, and if so, the default limit and page will be used (see below)

Pagination filters

filter default Type Description
page 1 int Shows results in the indicated page
limit 5 int Sets the maximum number of results per page (can be configured differently if requested through sales)

Sorting example usage

{
   "Filters": {
       ... filters ...
    },
"Sorting": {
    "by": "date",
    "direction": "desc"
    }
}
N.B. The sorting object can be omitted from the json body, and if so, the default by and direction will be used (see below)

Sorting filters

filter default Type Description
by date str Orders the results by either date, price, lastmodified, removed, mindate, maxdate, pricepsm, energyclass or distance relative to a POI
direction desc str List the results by ascending (asc) or descending (desc) order