# Realitica Listing API Documentation

<p><strong>Realitica Listing API</strong> 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 <code>null</code>. Rent prices carry the text after the amount in <code>price.period_text</code>. The phone number is not returned. An unknown or removed id returns a not billable 404 error.</p>

- **Documentation:** [https://scrappa.co/docs/realitica-api/realitica_listing](https://scrappa.co/docs/realitica-api/realitica_listing)
- **API group:** Realitica API
- **Endpoint:** `GET https://scrappa.co/api/realitica/v1/listing`

## 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 listing_id of a search item. Example: 3456582. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | The listing does not exist or was removed. This response is not billable. |
| 503 | Upstream Unavailable | Realitica could not be reached. This response is not billable and is retryable. |
| 503 | Unexpected Upstream Data | Realitica returned data in an unexpected shape. 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)