# Bezrealitky Listing API Documentation

<p><strong>Bezrealitky Listing API</strong> returns the full record of one advert: title and description in Czech and English, price with deposit, fee, service and utility charges, area, floors, condition, construction, ownership, energy class, features, address with region tree, coordinates, all images, dates as ISO 8601, mortgage hints and related adverts. Send the <code>id</code> from search (also as <code>{id}-{slug}</code>) or the full listing <code>url</code>.</p><p>A missing value is <code>null</code>, never 0. An advert that does not exist or is offline returns 404. The site shows no public agent profile, so none is returned.</p>

- **Documentation:** [https://scrappa.co/docs/bezrealitky-api/bezrealitky_listing](https://scrappa.co/docs/bezrealitky-api/bezrealitky_listing)
- **API group:** Bezrealitky API
- **Endpoint:** `GET https://scrappa.co/api/bezrealitky/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` | string | No | Listing id from search, or {id}-{slug}. Send id or url. |
| `url` | string | No | Full bezrealitky.cz listing URL (instead of id). |

## Example response

```json
{
    "data": {
        "id": "1082178",
        "geo": {
            "latitude": 49.2534774,
            "longitude": 16.5848348
        },
        "url": "https://www.bezrealitky.cz/nemovitosti-byty-domy/1082178-nabidka-pronajem-bytu-karnikova-brno",
        "area": 64,
        "tags": [
            "Vybaveno",
            "Parkov\u00e1n\u00ed",
            "Balk\u00f3n 6 m\u00b2"
        ],
        "floor": 1,
        "price": {
            "fee": null,
            "amount": 19000,
            "period": "month",
            "charges": 4000,
            "deposit": 25000,
            "currency": "CZK",
            "formatted": "19.000 K\u010d",
            "is_discounted": false,
            "original_amount": null,
            "service_charges": 500,
            "utility_charges": 3500,
            "service_charges_note": null,
            "utility_charges_note": null,
            "transfer_to_personal_ownership": null
        },
        "rooms": 2,
        "title": "Pron\u00e1jem bytu 2+1 64 m\u00b2",
        "images": [
            {
                "id": "28423094",
                "url": "https://\u2026/record_main/1792945052-pjsmtyuclf-20261006-133225.jpg",
                "main": true,
                "order": 1
            },
            {
                "id": "28423095",
                "url": "https://\u2026/record_main/1792945051-fmxvlpfqww-20261006-133303.jpg",
                "main": false,
                "order": 2
            }
        ],
        "status": {
            "active": true,
            "is_new": true,
            "reserved": false,
            "highlighted": false
        },
        "videos": [],
        "address": {
            "zip": "621 00",
            "city": "Brno",
            "full": "K\u00e1rn\u00edkova, Brno - \u0158e\u010dkovice, Jihomoravsk\u00fd kraj",
            "street": "K\u00e1rn\u00edkova",
            "district": "\u0158e\u010dkovice",
            "region_tree": [
                {
                    "id": "487",
                    "name": "Jihomoravsk\u00fd kraj",
                    "slug": "jihomoravsky-kraj",
                    "type": "administrative"
                },
                {
                    "id": "664",
                    "name": "okres Brno-m\u011bsto",
                    "slug": "okres-brno-mesto",
                    "type": "administrative"
                }
            ],
            "house_number": null
        },
        "related": [
            {
                "id": "464897",
                "url": "https://www.bezrealitky.cz/nemovitosti-byty-domy/464897-nabidka-pronajem-bytu-kosinova",
                "area": 42,
                "price": 20000,
                "address": "Ko\u0161inova, Brno - Kr\u00e1lovo Pole, Jihomoravsk\u00fd kraj",
                "currency": "CZK",
                "thumbnail": "https://\u2026/record_main/1488882660-wdfks-20170306-103402.jpg",
                "offer_type": "rent",
                "disposition": "2+kk",
                "estate_type": "apartment"
            }
        ],
        "building": {
            "age": null,
            "water": null,
            "sewage": null,
            "heating": null,
            "equipped": "furnished",
            "position": null,
            "condition": "very_good",
            "execution": null,
            "ownership": null,
            "situation": "quiet_part",
            "construction": "brick",
            "energy_class": null,
            "reconstruction": null,
            "front_garden_area": null
        },
        "features": {
            "lift": false,
            "garage": false,
            "parking": true,
            "roommate": false,
            "low_energy": false,
            "short_term": false,
            "cellar_area": null,
            "loggia_area": null,
            "balcony_area": 6,
            "barrier_free": false,
            "pet_friendly": null,
            "terrace_area": null
        },
        "mortgage": {
            "loan": null,
            "years": null,
            "rate_low": null,
            "rate_high": null
        },
        "title_en": "2 bedroom flat to rent, 64 m\u00b2",
        "amenities": [
            "Parkov\u00e1n\u00ed"
        ],
        "land_area": null,
        "land_type": null,
        "posted_at": "2026-10-25T17:35:18+01:00",
        "expires_at": "2026-11-24T17:35:19+01:00",
        "house_type": null,
        "offer_type": "rent",
        "page_title": "Pron\u00e1jem bytu 2+1 \u2022 64\u00a0m\u00b2 \u2022 K\u00e1rn\u00edkova \u2022 Brno - \u0158e\u010dkovice \u2022 bez RK",
        "parameters": [
            {
                "key": "id",
                "label": "\u010c\u00edslo inzer\u00e1tu",
                "value": "1082178"
            },
            {
                "key": "disposition",
                "label": "Dispozice",
                "value": "2+1"
            },
            {
                "key": "condition",
                "label": "Stav",
                "value": "Velmi dobr\u00fd"
            },
            {
                "key": "surface",
                "label": "Plocha",
                "value": "64 m\u00b2"
            },
            {
                "key": "price",
                "label": "Cena",
                "value": "19.000 K\u010d"
            }
        ],
        "description": "Dlouhodob\u00fd podn\u00e1jem kompletn\u011b vybaven\u00e9ho bytu 2+1 s velk\u00fdm balkonem, K\u00e1rn\u00edkova 20, Brno-\u0158e\u010dkovice\nNab\u00edz\u00edm k dlouhodob\u00e9mu podn\u00e1jmu kr\u00e1sn\u00fd, zrekonstruovan\u00fd a pln\u011b\u2026",
        "disposition": "2+1",
        "estate_type": "apartment",
        "external_id": null,
        "total_floors": 4,
        "tour_360_url": null,
        "available_from": "2026-11-01T00:00:00+01:00",
        "description_en": null,
        "points_of_interest": "[]"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The listing does not exist or is no longer online. This response is not billable. |
| 422 | Validation Error | A required parameter or a value is invalid, or the parameter does not exist. This response is not billable. |
| 503 | Upstream Unavailable | Bezrealitky could not be reached or returned data that does not match the request. 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)
