Skip to content
Scrappa Get API key
Realitica API 1 credit/request

Realitica Property Search API Documentation

GET https://scrappa.co/api/realitica/v1/search

Realitica Property Search API returns property for sale, short-term rent or long-term rent in Montenegro, Croatia, Serbia and Bosnia as JSON. Filter by country, region, text, property type, price, bedrooms and area, sort by newest, oldest or price, limit by posting age, and page through the results with 25 listings per page. Each listing carries the id, link, sentence title, advertiser, property type, bedrooms, area, price in EUR, location split into place, municipality, region and country, thumbnail and a text snippet. The response also returns the total result count, the real page, and the municipalities and property types of the result page as facets.

Notes: Price on request is null, never 0. Prices below 2 EUR are placeholders and are null as well. Realitica cannot filter by bedrooms, area or a Montenegrin municipality, so these filters are applied to the fetched page: search_metadata.filtered_out counts the removed items and a page can hold fewer than 25 listings. Page on has_next_page. A bathrooms filter is not supported and returns a 422 error. Map coordinates, fees and reviews do not exist on Realitica.

Realitica Property Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/realitica/v1/search
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "facets": {
            "locations": [
                {
                    "name": "Andrijevica",
                    "count": 13
                },
                {
                    "name": "Bar",
                    "count": 6132
                },
                {
                    "name": "Berane",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

13 optional filters available.

listing_type string Optional

sale (default), rent_short or rent_long. Example: rent_long.

Example value example
country string Optional

montenegro (default), croatia, serbia or bosnia. Example: croatia.

Example value US
region string Optional

Name from the locations route. Montenegro: a municipality such as Budva, searched as text, so it cannot be combined with query and total_results counts all text matches. Croatia, Serbia, Bosnia: a county such as Istra. Example: Istra.

Example value US
query string Optional

Free text keyword, 2 to 100 characters. Example: Budva.

Example value coffee shops
property_type string Optional

One or more of Home, Apartment, Land, Commercial, Hotel, Residential_lot, Agricultural_land, Campground, Garage. Repeat property_type[] or comma-separate. Example: Apartment.

Example value example
min_price integer Optional

Minimum price in EUR. Example: 100000.

Example value 10
max_price integer Optional

Maximum price in EUR. Example: 250000.

Example value 10
bedrooms integer Optional

Bedrooms 1 to 5, 5 means 5 or more. Applied to the fetched page: items without a known bedroom count are dropped. Example: 2.

Example value 10
min_area integer Optional

Minimum area in m2. Applied to the fetched page. Example: 50.

Example value 10
max_area integer Optional

Maximum area in m2. Applied to the fetched page. Example: 120.

Example value 10
sort string Optional

default, newest, oldest, price_asc or price_desc. Example: newest.

Example value relevance
posted_within string Optional

any (default), 7d, 1m or 1y. Example: 7d.

Example value example
page integer Optional

One-based page number, 25 results per page. Example: 2.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "facets": {
            "locations": [
                {
                    "name": "Andrijevica",
                    "count": 13
                },
                {
                    "name": "Bar",
                    "count": 6132
                },
                {
                    "name": "Berane",
                    "count": 47
                }
            ],
            "property_types": [
                "Apartment",
                "House",
                "Land",
                "Residential Lot",
                "Commercial Property",
                "Hotel",
                "Agricultural Land",
                "Garage",
                "Campground"
            ]
        },
        "listings": [
            {
                "url": "https://www.realitica.com/en/listing/3456582",
                "price": {
                    "amount": 240000,
                    "currency": "EUR"
                },
                "title": "is selling an apartment",
                "area_m2": 65,
                "snippet": "Apartment of 65 sq. m, located on the raised ground floor of a four-storey building at Lazi Street, bb, Budva. The apartment has a functional layout and consists of: a spacio...",
                "bedrooms": 1,
                "location": {
                    "text": "Lazi, Budva, Montenegro",
                    "place": "Lazi",
                    "region": null,
                    "country": "Montenegro",
                    "municipality": "Budva"
                },
                "thumbnail": "https://www.realitica.com/images/listing_photos/thumb_3456582_dsc_5273.jpg",
                "listing_id": 3456582,
                "listing_type": "sale",
                "property_type": "Apartment",
                "advertiser_name": "Monteflower"
            },
            {
                "url": "https://www.realitica.com/en/listing/3730448",
                "price": {
                    "amount": 225000,
                    "currency": "EUR"
                },
                "title": "is selling an apartment",
                "area_m2": 49,
                "snippet": "Two-Bedroom Apartment for Sale in Tivat \u2013 Kava Fully furnished and equipped two-bedroom apartment in the Kava neighbourhood of Tivat. The apartment has 49 m\u00b2 of living space, a t...",
                "bedrooms": 2,
                "location": {
                    "text": "Kava, Tivat, Montenegro",
                    "place": "Kava",
                    "region": null,
                    "country": "Montenegro",
                    "municipality": "Tivat"
                },
                "thumbnail": "https://www.realitica.com/images/listing_photos/thumb_3730448_20260922_164806r.jpg",
                "listing_id": 3730448,
                "listing_type": "sale",
                "property_type": "Apartment",
                "advertiser_name": "Mihailo"
            }
        ],
        "search_metadata": {
            "page": 1,
            "page_size": 25,
            "total_pages": 1896,
            "filtered_out": 0,
            "has_next_page": true,
            "total_results": 47376,
            "upstream_items": 25,
            "dropped_invalid": 0
        },
        "search_parameters": {
            "page": 1,
            "sort": "default",
            "country": "montenegro",
            "listing_type": "sale",
            "posted_within": "any"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter or a value is invalid. This response is not billable.

{
    "errors": {
        "field": [
            "The field is invalid."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

Realitica could not be reached. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Realitica could not be reached. Please retry shortly."
    },
    "success": false
}
503

Unexpected Upstream Data

Realitica returned data in an unexpected shape. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "INVALID_UPSTREAM_SHAPE",
        "message": "Realitica returned data in an unexpected shape. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.