# Nehnutelnosti Listing API Documentation
Nehnutelnosti Listing API returns one listing: price with the price per square meter, fees, area, floor, construction, condition, year built, energy certificate, attributes, address with coordinates, all photos, nearby places, the full description and the advertiser with its agency. Send the listing id from search (the slug is optional), or the full listing url.
Advertiser phone numbers are masked by the site and returned as shown. Photo links are signed by the site and expire after about a day, so fetch the listing again for fresh links. A listing that was taken down is a 404 and is not billable. The site has no bathroom data, so bathrooms is null.
- **Documentation:** [https://scrappa.co/docs/nehnutelnosti-api/nehnutelnosti_listing](https://scrappa.co/docs/nehnutelnosti-api/nehnutelnosti_listing)
- **API group:** Nehnutelnosti API
- **Endpoint:** `GET https://scrappa.co/api/nehnutelnosti/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 | Yes | Listing id from search, for example Juj4alyj1S5. |
| `slug` | string | No | Listing slug from search. Optional: the site finds the listing by id. |
| `url` | string | No | Full nehnutelnosti.sk listing URL, sent instead of id and slug. |
## Example response
```json
{
"data": {
"id": "Juj4alyj1S5",
"url": "https://www.nehnutelnosti.sk/detail/Juj4alyj1S5/halo-reality-predaj-dvojizbovy-byt-bratislava-podunajske-biskupice-bodrocka-exkluzivne-halo-reality",
"area": 49,
"slug": "halo-reality-predaj-dvojizbovy-byt-bratislava-podunajske-biskupice-bodrocka-exkluzivne-halo-reality",
"flags": {
"is_top": true,
"is_premium": false
},
"floor": 3,
"price": {
"fees": {
"energy_costs": null,
"energy_costs_included": false
},
"note": "Kone\u010dn\u00e1 cena vr\u00e1tane slu\u017eieb HALO reality a prov\u00edzie.",
"amount": 184990,
"per_m2": 3775.31,
"period": null,
"display": "184\u00a0990 \u20ac",
"currency": "EUR",
"on_request": false,
"per_m2_display": "3\u00a0775,31 \u20ac/m\u00b2"
},
"title": "HALO reality - Predaj, dvojizbov\u00fd byt Bratislava Podunajsk\u00e9 Biskupice, Bodrock\u00e1 - EXKLUZ\u00cdVNE HALO REALITY",
"photos": [
{
"url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzE1NjB4NDAwMC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/_A9TxK7Yf_fss",
"width": 1150,
"height": 767,
"small_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzM5MHgxMDAwL2ZpbHRlcnM6cXVhbGl0eSg4MCk6Zm9ybWF0KHdlYnApL2p1bA==/_A9TxK7Yf_fss",
"medium_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzc4MHgyMDAwL2ZpbHRlcnM6cXVhbGl0eSg4MCk6Zm9ybWF0KHdlYnApL2p1bA==/_A9TxK7Yf_fss",
"original_url": "https://img.unitedclassifieds.sk/foto/ZmlsdGVyczpmb3JtYXQod2VicCkvanVs/_A9TxK7Yf_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzE1NjB4NDAwMC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/prhamAaAj_fss",
"width": 1150,
"height": 767,
"small_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzM5MHgxMDAwL2ZpbHRlcnM6cXVhbGl0eSg4MCk6Zm9ybWF0KHdlYnApL2p1bA==/prhamAaAj_fss",
"medium_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzc4MHgyMDAwL2ZpbHRlcnM6cXVhbGl0eSg4MCk6Zm9ybWF0KHdlYnApL2p1bA==/prhamAaAj_fss",
"original_url": "https://img.unitedclassifieds.sk/foto/ZmlsdGVyczpmb3JtYXQod2VicCkvanVs/prhamAaAj_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzE1NjB4NDAwMC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/ihgCkUtrP_fss",
"width": 1150,
"height": 767,
"small_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzM5MHgxMDAwL2ZpbHRlcnM6cXVhbGl0eSg4MCk6Zm9ybWF0KHdlYnApL2p1bA==/ihgCkUtrP_fss",
"medium_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzc4MHgyMDAwL2ZpbHRlcnM6cXVhbGl0eSg4MCk6Zm9ybWF0KHdlYnApL2p1bA==/ihgCkUtrP_fss",
"original_url": "https://img.unitedclassifieds.sk/foto/ZmlsdGVyczpmb3JtYXQod2VicCkvanVs/ihgCkUtrP_fss"
}
],
"videos": [],
"category": {
"sub": "TWO_ROOM_APARTMENT",
"main": "APARTMENTS"
},
"headline": "2 izbov\u00fd byt na predaj",
"location": {
"geo": {
"lat": 48.1251722,
"lon": 17.2109494
},
"city": "Bratislava-Podunajsk\u00e9 Biskupice",
"name": "Bratislava-Podunajsk\u00e9 Biskupice, okres Bratislava II",
"county": "Bratislavsk\u00fd kraj",
"country": "Slovensko",
"district": "okres Bratislava II",
"geo_radius_m": 200
},
"tours_3d": [
{
"url": "https://my.matterport.com/show/?m=6bKDAV3pmi5",
"type": "MATTERPORT"
}
],
"bathrooms": null,
"condition": "P\u00f4vodn\u00fd stav",
"is_active": true,
"advertiser": {
"id": "cdcd7a3a-fcb4-4fcb-8e79-53a9ff103c27",
"name": "Mari\u00e1n Matu\u0161ek",
"slug": "marian-matusek-fcb4",
"type": "AGENT",
"phone": "0911 ...",
"agency": {
"id": "4304b4da-ebbe-400f-85bf-a4be6b2e4a2b",
"name": "HALO reality, s.r.o.",
"slug": "halo-reality-sro",
"is_pro": true,
"address": [
"Gustava \u0160v\u00e9niho 8",
"Prievidza"
],
"website": "https://www.haloreality.sk",
"logo_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzE4MHgxMjAvZmlsdGVyczpxdWFsaXR5KDEwMCk6Zm9ybWF0KHdlYnApL3B1cw==/RiQgqaFc__fss",
"company_id": "46565701"
},
"branch": {
"id": "ed8e6ea8-ba96-4b34-bf51-dcfa7bc794e5",
"name": "HALO reality Bratislava",
"slug": "halo-reality-bratislava-ba96",
"address": [
"Ra\u010dianska 77",
"Bratislava"
]
},
"is_pro": false,
"last_name": "Matu\u0161ek",
"photo_url": null,
"first_name": "Mari\u00e1n"
},
"attributes": [
{
"label": "Po\u010det pivn\u00edc",
"value": "1",
"important": false
},
{
"label": "Umiestnenie",
"value": "\u010eal\u0161ie nadzemn\u00e9 podla\u017eie",
"important": false
},
{
"label": "Orient\u00e1cia",
"value": "Z\u00e1padn\u00e1",
"important": false
},
{
"label": "Vlastn\u00edctvo",
"value": "Osobn\u00e9",
"important": false
},
{
"label": "Vykurovanie",
"value": "\u00dastredn\u00e9",
"important": false
},
{
"label": "Po\u010det izieb / miestnost\u00ed",
"value": "2",
"important": false
}
],
"created_at": "2026-09-28T16:30:14.692Z",
"updated_at": "2026-10-25T06:17:49.496Z",
"year_built": 1981,
"description": "Realitn\u00e1 kancel\u00e1ria HALO reality a Mari\u00e1n Matu\u0161ek, kontakt: ..., nehnute\u013enos\u0165 s ID: BA-73975:\nPon\u00faka exkluz\u00edvne na predaj 2-izbov\u00fd byt s v\u00fdmerou 49,40 m2 na Bodrockej ulici v Bratislave, v mestskej \u010dasti Podunajsk\u00e9 Biskupice. Byt sa nach\u00e1dza na 3. poschod\u00ed bytov\u00e9ho domu bez v\u00fd\u0165ahu a je orientovan\u00fd na z\u00e1padn\u00fa stranu. Hoci je v p\u00f4vodnom stave, je ihne\u010f ob\u00fdvate\u013en\u00fd a nov\u00e9mu majite\u013eovi pon\u00faka mo\u017enos\u0165 postupnej rekon\u0161trukcie pod\u013ea vlastn\u00fdch predst\u00e1v, bez nutnosti okam\u017eit\u00fdch ve\u013ek\u00fdch invest\u00edci\u00ed. Pred\u00e1va sa zariaden\u00fd a nach\u00e1dza sa v mimoriadne tichej a pokojnej lokalite s bezprobl\u00e9mov\u00fdm par",
"floor_plans": [],
"transaction": "Predaj",
"construction": "Panelov\u00e1",
"floors_total": 4,
"has_elevator": false,
"listing_type": "sale",
"published_at": "2026-10-21T13:23:57.000Z",
"energy_certificate": "nie je",
"points_of_interest": [
{
"id": 54045,
"geo": {
"lat": 48.1250048,
"lon": 17.2109055
},
"city": "Bratislava",
"name": "Mi\u00da P. Biskupice",
"street": "Troji\u010dn\u00e9 n\u00e1mestie",
"category": 4,
"postcode": "825 56",
"distance_m": 18
},
{
"id": 54044,
"geo": {
"lat": 48.1248983,
"lon": 17.2112754
},
"city": "Bratislava",
"name": "Mi\u00da P. Biskupice",
"street": "Troji\u010dn\u00e9 n\u00e1mestie",
"category": 4,
"postcode": "825 56",
"distance_m": 38
},
{
"id": 56645,
"geo": {
"lat": 48.1248822,
"lon": 17.211786
},
"city": "Bratislava",
"name": "Mi\u00da P. Biskupice",
"street": "Padl\u00fdch hrdinov",
"category": 4,
"postcode": "825 56",
"distance_m": 70
},
{
"id": 58643,
"geo": {
"lat": 48.1243628,
"lon": 17.2111702
},
"city": "Bratislava",
"name": "Tesavi - S\u00fakromn\u00e1 bilingv\u00e1lna matersk\u00e1 \u0161kola",
"street": "Troji\u010dn\u00e9 n\u00e1mestie",
"category": 2,
"postcode": "825 56",
"distance_m": 91
}
]
},
"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 location, listing, agency or agent does not exist. This response is not billable. |
| 503 | Upstream Unavailable | Nehnutelnosti.sk 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)