Nehnutelnosti Agency API returns a real-estate agency: name, address, coordinates, contacts, listing counts for sale and rent, average sale and rent prices, a few agents and branches, and the agency listings (30 per page). Send the agency slug from a listing advertiser. To read page 2 and later, also send the agency id from the same advertiser. Pages are only returned when the site confirms the page number.
An average of 0 on the site means no data and is returned as null. A valid empty page is billed; an unknown agency is a 404 and is not billable.
Run this endpoint
Nehnutelnosti Agency API Documentation
1 credit/request
Endpoint
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.
2 optional filters available.
slug
string
Required
Agency slug from a listing advertiser, for example halo-reality-sro.
Example value
example
id
string
Optional
Agency id from a listing advertiser. Required for page 2 and later.
Example value
1234567890
page
integer
Optional
One-based page of the agency listings. Default 1.
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
{
"data": {
"agency": {
"id": "4304b4da-ebbe-400f-85bf-a4be6b2e4a2b",
"geo": {
"lat": 48.771622,
"lon": 18.6206772
},
"name": "HALO reality, s.r.o.",
"slug": "halo-reality-sro",
"agents": [
{
"id": "2d5a0d40-1dde-449f-a73b-e99a6fe9dfe6",
"name": "Adri\u00e1n Ki\u0161a",
"slug": "adrian-kisa",
"is_pro": false,
"photo_url": null
},
{
"id": "801a6c05-9255-49a3-989e-239f1b62ffa8",
"name": "Andrea F\u00e1bry Kubi\u0161ov\u00e1",
"slug": "andrea-fabry-kubisova",
"is_pro": false,
"photo_url": null
}
],
"counts": {
"total": 1399,
"for_rent": 86,
"for_sale": 840,
"districts": 28,
"average_rent_price": 857.96,
"average_sale_price": 137989.85
},
"is_pro": true,
"photos": [
{
"url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzc4MHgyMDAwL2ZpbHRlcnM6cXVhbGl0eSg4MCk6Zm9ybWF0KHdlYnApL2p1bA==/a_7uBjmVn_fss"
}
],
"address": {
"city": "Prievidza",
"street": "Gustava \u0160v\u00e9niho",
"country": "Slovensko",
"postal_code": "97101",
"street_number": "8"
},
"branches": [
{
"id": "ac3f1f92-a0cc-418c-95d0-86859bfdc1a3",
"city": "Bansk\u00e1 Bystrica",
"name": "HALO reality Bansk\u00e1 Bystrica",
"slug": "halo-reality-banska-bystrica-a0cc",
"street": "N\u00e1mestie Slobody",
"active_listings": 49
},
{
"id": "ed8e6ea8-ba96-4b34-bf51-dcfa7bc794e5",
"city": "Bratislava",
"name": "HALO reality Bratislava",
"slug": "halo-reality-bratislava-ba96",
"street": "Ra\u010dianska",
"active_listings": 154
}
],
"contacts": {
"phone": "0915238411",
"website": "https://www.haloreality.sk",
"youtube": null,
"facebook": null,
"linkedin": null,
"whatsapp": null,
"has_email": true,
"instagram": null,
"messenger": null,
"other_phones": []
},
"logo_url": "https://img.unitedclassifieds.sk/foto/Zml0LWluLzE0MHgxNDAvZmlsdGVyczpxdWFsaXR5KDg4KTpmb3JtYXQod2VicCkvcHVz/RiQgqaFc__fss",
"is_active": true,
"legal_name": "HALO reality s. r. o.",
"description": "HALO reality je profesion\u00e1lna realitn\u00e1 spolo\u010dnos\u0165 p\u00f4sobiaca na slovenskom trhu u\u017e od roku 2012. Moment\u00e1lne so zast\u00fapen\u00edm v 64 okresoch Slovenska, 100 realitn\u00fdmi makl\u00e9rmi a s uskuto\u010dnen\u00fdmi viac ako 12 000 obchodmi patr\u00edme k l\u00eddrom na slovenskom realitnom trhu. Dostali sme ocenenie za rok 2025, 2024 ako \"V\u00ed\u0165az, najv\u00e4\u010d\u0161\u00ed v realitnom biznise\" od nez\u00e1vislej organiz\u00e1cie The Spectator.",
"agents_count": 92,
"branches_count": 24
},
"listings": [
{
"id": "JuvTSu95O-8",
"url": "https://www.nehnutelnosti.sk/detail/JuvTSu95O-8/halo-reality---kupa-rodinny-dom-bitarova",
"area": 120,
"slug": "halo-reality---kupa-rodinny-dom-bitarova",
"flags": {
"is_top": false,
"has_video": false,
"is_premium": false,
"has_3d_tour": false,
"has_floor_plan": false,
"is_developer_project": false
},
"price": {
"note": null,
"amount": null,
"per_m2": null,
"period": null,
"display": "320\u00a0000 \u20ac",
"currency": "EUR",
"on_request": true,
"per_m2_display": null
},
"title": "HALO reality - K\u00fapa rodinn\u00fd dom Bitarov\u00e1",
"photos": [
{
"url": "https://img.unitedclassifieds.sk/foto/NTg2eDQ0MC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/Wzz8MdwdA_fss"
}
],
"category": "Domy",
"location": {
"city": "Bitarov\u00e1",
"name": "Bitarov\u00e1 (okres \u017dilina)",
"county": "\u017dilinsk\u00fd kraj",
"street": null,
"country": "Slovensko",
"district": "okres \u017dilina"
},
"condition": "P\u00f4vodn\u00fd stav",
"advertiser": {
"name": "Ing. Daniela Maz\u00farov\u00e1",
"is_pro": false,
"photo_url": "https://img.unitedclassifieds.sk/foto/NTB4NTAvZmlsdGVyczpxdWFsaXR5KDg4KTpmb3JtYXQod2VicCkvcHVz/RiQgqaFc__fss",
"agency_name": "HALO reality, s.r.o."
},
"description": "Pre konkr\u00e9tneho klienta h\u013ead\u00e1me RD v okol\u00ed \u017diliny, ktor\u00fd sp\u013a\u0148a nasleduj\u00face krit\u00e9ri\u00e1: - Lokalita: Bitarov\u00e1, H\u00f4rky, Brezany, Ov\u010diarsko - Pozemok: V\u00e4\u010d\u0161ia v\u00fdmera (400 m\u00b2 +)- Gar\u00e1\u017e alebo st\u00e1tie pre 2 aut\u00e1 - Stav: Novostavba alebo zachoval\u00fd stav. Za ponuky a spolupr\u00e1cu vopred \u010fakujem. \n\n Bli\u017e\u0161ie inform\u00e1cie V\u00e1m radi poskytneme na telef\u00f3nnom \u010d\u00edsle 0900 000 000 alebo na danielamazurova@haloreality.sk. ID dopytu: D-27133\n \n Nehnute\u013enos\u0165 pred\u00e1vate/kupujete jeden-dvakr\u00e1t za \u017eivot, nechajte to na profesion\u00e1lov v realit\u00e1ch, ktor\u00fdm D\u00d4VERUJ\u00da TIS\u00cdCE PRED\u00c1VAJ\u00daCICH PO CELOM SLOVENSKU - u n\u00e1s n\u00e1jdete viac ako 1 300 aktu\u00e1lnych pon\u00fak.",
"subcategory": "Rodinn\u00fd dom",
"transaction": "Dopyt",
"listing_type": null
},
{
"id": "Ju1KBUha41Y",
"url": "https://www.nehnutelnosti.sk/detail/Ju1KBUha41Y/halo-reality---kupa-dvojizbovy-byt-zilina",
"area": 60,
"slug": "halo-reality---kupa-dvojizbovy-byt-zilina",
"flags": {
"is_top": false,
"has_video": false,
"is_premium": false,
"has_3d_tour": false,
"has_floor_plan": false,
"is_developer_project": false
},
"price": {
"note": null,
"amount": null,
"per_m2": null,
"period": null,
"display": "170\u00a0000 \u20ac",
"currency": "EUR",
"on_request": true,
"per_m2_display": null
},
"title": "HALO reality - K\u00fapa dvojizbov\u00fd byt \u017dilina",
"photos": [
{
"url": "https://img.unitedclassifieds.sk/foto/NTg2eDQ0MC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/Wzz8MdwdA_fss"
}
],
"category": "Byty",
"location": {
"city": "\u017dilina",
"name": "\u017dilina (okres \u017dilina)",
"county": "\u017dilinsk\u00fd kraj",
"street": null,
"country": "Slovensko",
"district": "okres \u017dilina"
},
"condition": "P\u00f4vodn\u00fd stav",
"advertiser": {
"name": "Ing. Daniela Maz\u00farov\u00e1",
"is_pro": false,
"photo_url": "https://img.unitedclassifieds.sk/foto/NTB4NTAvZmlsdGVyczpxdWFsaXR5KDg4KTpmb3JtYXQod2VicCkvcHVz/RiQgqaFc__fss",
"agency_name": "HALO reality, s.r.o."
},
"description": "Pre konkr\u00e9tneho klienta s\u00farne h\u013ead\u00e1me 2i byt v lokalite Solinky, Vl\u010dince, Hliny. Byt by mal by\u0165 rekon\u0161truovan\u00fd alebo aspo\u0148 \u010diasto\u010dne rekon\u0161truovan\u00fd. Ide\u00e1lne s balk\u00f3nom/lod\u017eiou a pivnicou. \n\n Bli\u017e\u0161ie inform\u00e1cie V\u00e1m radi poskytneme na telef\u00f3nnom \u010d\u00edsle 0900 000 000 alebo na danielamazurova@haloreality.sk. ID dopytu: D-27237\n \n Nehnute\u013enos\u0165 pred\u00e1vate/kupujete jeden-dvakr\u00e1t za \u017eivot, nechajte to na profesion\u00e1lov v realit\u00e1ch, ktor\u00fdm D\u00d4VERUJ\u00da TIS\u00cdCE PRED\u00c1VAJ\u00daCICH PO CELOM SLOVENSKU - u n\u00e1s n\u00e1jdete viac ako 1 300 aktu\u00e1lnych pon\u00fak.",
"subcategory": "2 izbov\u00fd byt",
"transaction": "Dopyt",
"listing_type": null
},
{
"id": "JuPm5EvU_qZ",
"url": "https://www.nehnutelnosti.sk/detail/JuPm5EvU_qZ/halo-reality---kupa-jednoizbovy-byt-zilina",
"area": 40,
"slug": "halo-reality---kupa-jednoizbovy-byt-zilina",
"flags": {
"is_top": false,
"has_video": false,
"is_premium": false,
"has_3d_tour": false,
"has_floor_plan": false,
"is_developer_project": false
},
"price": {
"note": null,
"amount": null,
"per_m2": null,
"period": null,
"display": "150\u00a0000 \u20ac",
"currency": "EUR",
"on_request": true,
"per_m2_display": null
},
"title": "HALO reality - K\u00fapa jednoizbov\u00fd byt \u017dilina",
"photos": [
{
"url": "https://img.unitedclassifieds.sk/foto/NTg2eDQ0MC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/qXx-eryXV_fss"
}
],
"category": "Byty",
"location": {
"city": "\u017dilina",
"name": "\u017dilina (okres \u017dilina)",
"county": "\u017dilinsk\u00fd kraj",
"street": null,
"country": "Slovensko",
"district": "okres \u017dilina"
},
"condition": "P\u00f4vodn\u00fd stav",
"advertiser": {
"name": "Ing. Daniela Maz\u00farov\u00e1",
"is_pro": false,
"photo_url": "https://img.unitedclassifieds.sk/foto/NTB4NTAvZmlsdGVyczpxdWFsaXR5KDg4KTpmb3JtYXQod2VicCkvcHVz/RiQgqaFc__fss",
"agency_name": "HALO reality, s.r.o."
},
"description": "Pre konkr\u00e9tneho klienta h\u013ead\u00e1me 1-izbov\u00fd byt na s\u00eddlisku Vl\u010dince, Hliny alebo Solinky. Byt by mal ma\u0165 balk\u00f3n/lod\u017eiu, rekon\u0161trukcia/\u010diasto\u010dn\u00e1 rekon\u0161trukcia v\u00edtan\u00e1. Bytov\u00fd dom by mal ma\u0165 v\u00fd\u0165ah, pr\u00edpadne by sa mal nach\u00e1dza\u0165 na pr\u00edzem\u00ed. \u010eakujem za ponuky \n\n Bli\u017e\u0161ie inform\u00e1cie V\u00e1m radi poskytneme na telef\u00f3nnom \u010d\u00edsle 0900 000 000 alebo na danielamazurova@haloreality.sk. ID dopytu: D-27084\n \n Nehnute\u013enos\u0165 pred\u00e1vate/kupujete jeden-dvakr\u00e1t za \u017eivot, nechajte to na profesion\u00e1lov v realit\u00e1ch, ktor\u00fdm D\u00d4VERUJ\u00da TIS\u00cdCE PRED\u00c1VAJ\u00daCICH PO CELOM SLOVENSKU - u n\u00e1s n\u00e1jdete viac ako 1 300 aktu\u00e1lnych pon\u00fak.",
"subcategory": "1 izbov\u00fd byt",
"transaction": "Dopyt",
"listing_type": null
}
],
"pagination": {
"page": 1,
"has_next": true,
"per_page": 30,
"total_count": 1399,
"total_pages": 47
}
},
"meta": {
"billable": true,
"endpoint_family": "agency"
},
"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": {
"slug": [
"The slug field is required."
]
},
"message": "The request validation failed"
}
404
Not Found
The location, listing, agency or agent does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "agency"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}
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.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "agency"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Nehnutelnosti.sk could not be reached. 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.