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

Realitica Listing API Documentation

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

Realitica Listing API returns the full record of one property listing as JSON: type, district, location, address, price, bedrooms, baths, living and land area, parking spots, year built, energy label, distance to the sea, features, description, publish and modification dates, photos, tags and advertiser. Fields the ad does not state are null. Rent prices carry the text after the amount in price.period_text. The phone number is not returned. An unknown or removed id returns a not billable 404 error.

Realitica Listing API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/realitica/v1/listing
Auth header
x-api-key
Cost
1 credit/request
id = 1234567890
Response preview
200 OK
{
    "data": {
        "url": "https://www.realitica.com/en/listing/3456582",
        "tags": [
            "Real Estate Lazi",
            "For Sale Apartments Lazi",
            "Real Estate Budva",
            "For Sale Apartments Budva",
            "Apartments Budva Montenegro for Rent by Owner"
        ],
        "type": "Apartment For Sale",
        "price": {
            "amount": 240000,
            "currency": "EUR",
...

Parameters

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

Runnable path

1 required parameter needed before sending a request.

id integer Required

The listing_id of a search item. Example: 3456582.

Example value 1234567890

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": {
        "url": "https://www.realitica.com/en/listing/3456582",
        "tags": [
            "Real Estate Lazi",
            "For Sale Apartments Lazi",
            "Real Estate Budva",
            "For Sale Apartments Budva",
            "Apartments Budva Montenegro for Rent by Owner"
        ],
        "type": "Apartment For Sale",
        "price": {
            "amount": 240000,
            "currency": "EUR",
            "period_text": null
        },
        "title": "Apartment For Sale, Lazi",
        "photos": [
            "https://www.realitica.com/images/listing_photos/3456582_dsc_5273.jpg",
            "https://www.realitica.com/images/listing_photos/3456582_dsc_5281.jpg"
        ],
        "address": "Lazi BB, Budva",
        "bedrooms": 1,
        "district": "Budva",
        "features": [
            "Air Conditioning"
        ],
        "location": "Lazi",
        "bathrooms": 1,
        "published": "2024-12-21",
        "advertiser": {
            "website": "monteflower.me/",
            "country_code": "ME",
            "advertiser_id": 127210,
            "registration_number": "50354650"
        },
        "listing_id": 3456582,
        "thumbnails": [
            "https://www.realitica.com/images/listing_photos/thumb_3456582_dsc_5273.jpg",
            "https://www.realitica.com/images/listing_photos/thumb_3456582_dsc_5281.jpg"
        ],
        "year_built": 2011,
        "description": "Apartment of 65 sq. m, located on the raised ground floor of a four-storey building at Lazi Street, bb, Budva.\n\r\n\n\r\nThe apartment has a functional layout and consists of:\n\r\n\n\r\na spacious living room w...",
        "energy_label": null,
        "land_area_m2": null,
        "last_modified": "2026-10-05",
        "parking_spots": null,
        "living_area_m2": 65,
        "distance_to_sea_m": 850
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "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"
}
404

Not Found

The listing does not exist or was removed. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "listing"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested resource was not found."
    },
    "success": false
}
503

Upstream Unavailable

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

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "listing"
    },
    "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": "listing"
    },
    "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.