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.
- **Documentation:** [https://scrappa.co/docs/nehnutelnosti-api/nehnutelnosti_agent](https://scrappa.co/docs/nehnutelnosti-api/nehnutelnosti_agent) - **API group:** Nehnutelnosti API - **Endpoint:** `GET https://scrappa.co/api/nehnutelnosti/agent` ## 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 | | --- | --- | --- | --- | | `slug` | string | Yes | Agent slug from a listing advertiser, for example marian-matusek-fcb4. | | `id` | string | Yes | Agent id (a UUID) from a listing advertiser. | | `page` | integer | No | One-based page of the agent listings. Default 1. | ## Example response ```json { "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 | 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)