Nehnutelnosti Agent API returns a real-estate agent: name, agency, contacts, listing counts and the agent listings (30 per page). Send the agent slug and id from a listing advertiser. Phone numbers appear as the site shows them. Header fields the agent page does not carry are null, never 0 or an empty text.
An unknown agent is a 404 and is not billable. Pages are only returned when the site confirms the page number.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
1 optional filter available.
string
Required
Agent slug from a listing advertiser, for example marian-matusek-fcb4.
example
string
Required
Agent id (a UUID) from a listing advertiser.
1234567890
integer
Optional
One-based page of the agent listings. Default 1.
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": {
"agent": {
"id": "cdcd7a3a-fcb4-4fcb-8e79-53a9ff103c27",
"name": "Mari\u00e1n Matu\u0161ek",
"slug": "marian-matusek-fcb4",
"agency": {
"id": "4304b4da-ebbe-400f-85bf-a4be6b2e4a2b",
"name": "HALO reality, s.r.o.",
"slug": "halo-reality-sro",
"address": {
"city": "Prievidza",
"street": "Gustava \u0160v\u00e9niho",
"street_number": "8"
},
"logo_url": "https://img.unitedclassifieds.sk/foto/ODB4NjAvZmlsdGVyczpxdWFsaXR5KDg4KTpmb3JtYXQod2VicCkvcHVz/RiQgqaFc__fss",
"is_branch": false
},
"awards": [],
"counts": {
"total": 3,
"for_rent": 0,
"for_sale": 0,
"districts": null,
"average_rent_price": null,
"average_sale_price": null
},
"contacts": {
"phone": "0900 000 000",
"website": null,
"youtube": null,
"facebook": null,
"linkedin": null,
"whatsapp": null,
"has_email": true,
"instagram": null,
"messenger": null,
"other_phones": []
},
"licenses": [],
"services": [],
"is_active": true,
"last_name": "Matu\u0161ek",
"photo_url": null,
"first_name": "Mari\u00e1n",
"package_valid_to": "2027-03-18T22:59:59.000Z"
},
"listings": [
{
"id": "Jug6OTD-YYK",
"url": "https://www.nehnutelnosti.sk/detail/Jug6OTD-YYK/halo-reality---predajl-stvorizbovy-byt-bratislava-podunajske-biskupicel-dolne-hony",
"area": 75,
"slug": "halo-reality---predajl-stvorizbovy-byt-bratislava-podunajske-biskupicel-dolne-hony",
"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": 3399.87,
"period": null,
"display": "254\u00a0990 \u20ac",
"currency": "EUR",
"on_request": true,
"per_m2_display": "3\u00a0399,87 \u20ac/m\u00b2"
},
"title": "HALO reality - Predaj, \u0161tvorizbov\u00fd byt Bratislava Podunajsk\u00e9 Biskupice, Doln\u00e9 hony",
"photos": [
{
"url": "https://img.unitedclassifieds.sk/foto/NTg2eDQ0MC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/uB4cwYDBR_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/F5XuMQBMD_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/JREv8Edfri_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/igS1WJPnW_fss"
}
],
"category": "Byty",
"location": {
"city": "Bratislava-Podunajsk\u00e9 Biskupice",
"name": "Bratislava-Podunajsk\u00e9 Biskupice (okres Bratislava II)",
"county": "Bratislavsk\u00fd kraj",
"street": null,
"country": "Slovensko",
"district": "okres Bratislava II"
},
"condition": "\u010ciasto\u010dn\u00e1 rekon\u0161trukcia",
"advertiser": {
"name": "Mari\u00e1n Matu\u0161ek",
"is_pro": false,
"photo_url": null,
"agency_name": "HALO reality, s.r.o."
},
"description": null,
"subcategory": "4 izbov\u00fd byt",
"transaction": "Predaj",
"listing_type": "sale"
},
{
"id": "Juj4alyj1S5",
"url": "https://www.nehnutelnosti.sk/detail/Juj4alyj1S5/halo-reality---predajl-dvojizbovy-byt-bratislava-podunajske-biskupicel-bodrocka---exkluzivne-halo-reality",
"area": 49,
"slug": "halo-reality---predajl-dvojizbovy-byt-bratislava-podunajske-biskupicel-bodrocka---exkluzivne-halo-reality",
"flags": {
"is_top": true,
"has_video": false,
"is_premium": false,
"has_3d_tour": true,
"has_floor_plan": false,
"is_developer_project": false
},
"price": {
"note": null,
"amount": null,
"per_m2": 3775.31,
"period": null,
"display": "184\u00a0990 \u20ac",
"currency": "EUR",
"on_request": true,
"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/NTg2eDQ0MC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/_A9TxK7Yf_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/prhamAaAj_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/ihgCkUtrP_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/pEYc3Isd3_fss"
}
],
"category": "Byty",
"location": {
"city": "Bratislava-Podunajsk\u00e9 Biskupice",
"name": "Bratislava-Podunajsk\u00e9 Biskupice (okres Bratislava II)",
"county": "Bratislavsk\u00fd kraj",
"street": null,
"country": "Slovensko",
"district": "okres Bratislava II"
},
"condition": "P\u00f4vodn\u00fd stav",
"advertiser": {
"name": "Mari\u00e1n Matu\u0161ek",
"is_pro": false,
"photo_url": null,
"agency_name": "HALO reality, s.r.o."
},
"description": null,
"subcategory": "2 izbov\u00fd byt",
"transaction": "Predaj",
"listing_type": "sale"
},
{
"id": "JulP1vCJqXL",
"url": "https://www.nehnutelnosti.sk/detail/JulP1vCJqXL/halo-reality---predajl-zahradna-chata-marianka---novostavba",
"area": 28,
"slug": "halo-reality---predajl-zahradna-chata-marianka---novostavba",
"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": 4496.43,
"period": null,
"display": "125\u00a0900 \u20ac",
"currency": "EUR",
"on_request": true,
"per_m2_display": "4\u00a0496,43 \u20ac/m\u00b2"
},
"title": "HALO reality - Predaj, z\u00e1hradn\u00e1 chata Marianka - NOVOSTAVBA",
"photos": [
{
"url": "https://img.unitedclassifieds.sk/foto/NTg2eDQ0MC9maWx0ZXJzOnF1YWxpdHkoODApOmZvcm1hdCh3ZWJwKS9qdWw=/GqfQlcmfc_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/k3uckm6EF_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/h5HMwjSdC_fss"
},
{
"url": "https://img.unitedclassifieds.sk/foto/MTkweDE0My9maWx0ZXJzOnF1YWxpdHkoNjApOmZvcm1hdCh3ZWJwKS9qdWw=/CoIaUoZYP_fss"
}
],
"category": "Chaty a chalupy",
"location": {
"city": "Marianka",
"name": "Marianka (okres Malacky)",
"county": "Bratislavsk\u00fd kraj",
"street": null,
"country": "Slovensko",
"district": "okres Malacky"
},
"condition": "Novostavba",
"advertiser": {
"name": "Mari\u00e1n Matu\u0161ek",
"is_pro": false,
"photo_url": null,
"agency_name": "HALO reality, s.r.o."
},
"description": null,
"subcategory": "Z\u00e1hradn\u00e1 chatka",
"transaction": "Predaj",
"listing_type": "sale"
}
],
"pagination": {
"page": 1,
"has_next": false,
"per_page": 30,
"total_count": 3,
"total_pages": 1
}
},
"meta": {
"billable": true,
"endpoint_family": "agent"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"id": [
"The id field is required."
]
},
"message": "The request validation failed"
}Not Found
The location, listing, agency or agent does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "agent"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}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": "agent"
},
"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.