--- title: "Halo Oglasi API: JSON data, 5 endpoints, 1 credit per call" description: "Halo Oglasi API for Serbian property search, listings, agencies, agency ads and location autocomplete as JSON, sale or rent. 1 credit per successful call." url: https://perceptlayer.com/apis/halo-oglasi --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Halo Oglasi 1 credit per call 5 endpoints 18 datapoints # Halo Oglasi API Halo Oglasi API for Serbian property search, listings, agencies, agency ads and location autocomplete as JSON, sale or rent. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Halo Oglasi GET /v1/halo-oglasi/search?listing\_type=sale&property\_type=flat&min\_price=80000&max\_price=150000&sort=price\_asc ``` { "success": true, "data": { "pagination": { "page": 1, "per_page": 20, "total_count": 4490, "total_pages": 225, "has_next_page": true, "filtered_out": 0, "duplicates_removed": 0 }, "items": [ { "id": "5425646789451", "title": "Mirijevski venac, 24m2 renoviran stan sa galerijom", "url": "https://www.halooglasi.com/nekretnine/prodaja-stanova/mirijevski-venac-24m2-renoviran-stan-sa-galer/5425646789451", "path": "/nekretnine/prodaja-stanova/mirijevski-venac-24m2-renoviran-stan-sa-galer/5425646789451", "price": { "amount": 80000, "currency": "EUR" }, "price_per_m2": { "amount": 4211, "currency": "EUR" }, "area_m2": 19, "rooms": 1, "floor": 0, "floor_label": "VPR", "total_floors": 7, "location": { "city": "Beograd", "area": "Opština Zvezdara", "micro_location": "Mirijevo", "street": "Vladislava Bajčevića", "places": [ "Beograd", "Opština Zvezdara", "Mirijevo" ] }, "advertiser_type": "agency", "image_count": 8, "thumbnail": "https://img.halooglasi.com/slike/oglasi/Thumbs/260219/m/mirijevo-renoviran-stan-bez-ulaganja-id1187-5425646789451-71814765795.jpg", "published_at": "2026-11-02", "short_description": "Kondor nekretnine su u prilici da Vam ponude odličan, renoviran stan, uknjižen na 19m2+ 5m2 galerija, koja je visine 2m , nalazi se na prvom spratu...", "has_map_position": true }, { "id": "5425646660783", "title": "Uknjižen stan - u sistemu rentiranja A12", "url": "https://www.halooglasi.com/nekretnine/prodaja-stanova/uknjizen-stan---u-sistemu-rentiranja-a12/5425646660783", "path": "/nekretnine/prodaja-stanova/uknjizen-stan---u-sistemu-rentiranja-a12/5425646660783", "price": { "amount": 80028, "currency": "EUR" }, "price_per_m2": { "amount": 1455, "currency": "EUR" }, "area_m2": 55, "rooms": 2, "floor": 1, "floor_label": "I", "total_floors": 2, "location": { "city": "Valjevo", "area": "Okolno mesto", "micro_location": "Divčibare", "street": "Valjevska", "places": [ "Valjevo", "Okolno mesto", "Divčibare" ] }, "advertiser_type": "investor", "image_count": 10, "thumbnail": "https://img.halooglasi.com/slike/oglasi/Thumbs/260311/m/uknjizen-stan---u-sistemu-rentiranja-5425646660783-71815014747.jpg", "published_at": "2026-10-30", "short_description": "Prodajemo luksuzan stan na Divčibarama, spreman za useljenje odmah. Mogućnost opremanja stana prema slikama u oglasu (posebna ponuda). Objekat je...", "has_map_position": true }, { "id": "5425647962257", "title": "Na prodaju dvosoban stan na Zlatiboru.", "url": "https://www.halooglasi.com/nekretnine/prodaja-stanova/na-prodaju-dvosoban-stan-na-zlatiboru/5425647962257", "path": "/nekretnine/prodaja-stanova/na-prodaju-dvosoban-stan-na-zlatiboru/5425647962257", "price": { "amount": 80850, "currency": "EUR" }, "price_per_m2": { "amount": 1650, "currency": "EUR" }, "area_m2": 49, "rooms": 3, "floor": 2, "floor_label": "II", "location": { "city": "Zlatibor", "area": "Okolno mesto", "micro_location": "Čolovića brdo", "street": "Vranjevina", "places": [ "Zlatibor", "Okolno mesto", "Čolovića brdo" ] }, "advertiser_type": "owner", "image_count": 11, "thumbnail": "https://img.halooglasi.com/slike/oglasi/Thumbs/261110/m/na-prodaju-dvosoban-stan-na-zlatiboru-5425647962257-71817631853.jpg", "published_at": "2026-11-10", "short_description": "Prodajem dvosoban stan 49m2 na Zlatiboru kompletno opremljen. Stan se nalazi na 1km od centra, naselje Vranjevina. Stan posjeduje dnevni boravak,...", "has_map_position": true } ], "facets": { "advertiser_type": { "filter_param": "advertiser_type", "values": [ { "id": 387238, "label": "Agencija", "count": 4092, "filter_value": "agency" }, { "id": 387237, "label": "Vlasnik", "count": 214, "filter_value": "owner" }, { "id": 387300, "label": "Investitor", "count": 184, "filter_value": "investor" } ] }, "building_type": { "filter_param": "building_type", "values": [ { "id": 387234, "label": "Stara gradnja", "count": 683, "filter_value": "old" }, { "id": 387235, "label": "Novogradnja", "count": 1644, "filter_value": "new" } ] }, "condition": { "filter_param": "condition_ids", "values": [ { "id": 260581, "label": "Izvorno stanje", "count": 469, "filter_value": 260581 }, { "id": 370347, "label": "Renovirano", "count": 537, "filter_value": 370347 }, { "id": 11950001, "label": "Lux", "count": 744, "filter_value": 11950001 } ] }, "heating": { "filter_param": "heating_ids", "values": [ { "id": 1542, "label": "CG", "count": 908, "filter_value": 1542 }, { "id": 1543, "label": "EG", "count": 1330, "filter_value": 1543 }, { "id": 1544, "label": "TA", "count": 585, "filter_value": 1544 } ] }, "additional": { "filter_param": "feature_ids", "values": [ { "id": 12000001, "label": "Odmah useljiv", "count": 1326, "filter_value": 12000001 }, { "id": 12000004, "label": "Uknjižen", "count": 2088, "filter_value": 12000004 }, { "id": 12000025, "label": "Nije poslednji sprat", "count": 1406, "filter_value": 12000025 } ] }, "extras": { "filter_param": "feature_ids", "values": [ { "id": 12100001, "label": "Terasa", "count": 2861, "filter_value": 12100001 }, { "id": 12100018, "label": "Francuski balkon", "count": 59, "filter_value": 12100018 }, { "id": 12100019, "label": "Lođa", "count": 343, "filter_value": 12100019 } ] }, "media": { "with_images": 4487, "with_video": 172, "with_3d": 95 } }, "applied_filters": { "listing_type": "sale", "property_type": "flat", "sort": "price_asc", "min_price": 80000, "max_price": 150000 } }, "meta": { "endpoint_family": "search", "request_id": "req_e279a18c0c8b470690e4a1353f1b4aac", "credits_charged": 1, "credits_remaining": 1866 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | title string | url url | path string | price object | price\_per\_m2 object | area\_m2 integer | rooms integer | floor integer | floor\_label string | total\_floors number | location object | advertiser\_type string | image\_count integer | thumbnail url | published\_at string | short\_description string | has\_map\_position boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 5425646789451 | Mirijevski venac, 24m2 renoviran stan sa galerijom | https://www.halooglasi.com/nekretnine/prodaja-stanova/mirijevski-venac-24m2-renoviran-stan-sa-galer/5425646789451 | /nekretnine/prodaja-stanova/mirijevski-venac-24m2-renoviran-stan-sa-galer/5425646789451 | {2 fields} | {2 fields} | 19 | 1 | 0 | VPR | 7 | {5 fields} | agency | 8 | https://img.halooglasi.com/slike/oglasi/Thumbs/260219/m/mirijevo-renoviran-stan-bez-ulaganja-id1187-5425646789451-71814765795.jpg | 2026-11-02 | Kondor nekretnine su u prilici da Vam ponude odličan, renoviran stan, uknjižen na 19m2+ 5m2 galerija, koja je visine 2m , nalazi se na prvom spratu... | true | | 2 | 5425646660783 | Uknjižen stan - u sistemu rentiranja A12 | https://www.halooglasi.com/nekretnine/prodaja-stanova/uknjizen-stan---u-sistemu-rentiranja-a12/5425646660783 | /nekretnine/prodaja-stanova/uknjizen-stan---u-sistemu-rentiranja-a12/5425646660783 | {2 fields} | {2 fields} | 55 | 2 | 1 | I | 2 | {5 fields} | investor | 10 | https://img.halooglasi.com/slike/oglasi/Thumbs/260311/m/uknjizen-stan---u-sistemu-rentiranja-5425646660783-71815014747.jpg | 2026-10-30 | Prodajemo luksuzan stan na Divčibarama, spreman za useljenje odmah. Mogućnost opremanja stana prema slikama u oglasu (posebna ponuda). Objekat je... | true | | 3 | 5425647962257 | Na prodaju dvosoban stan na Zlatiboru. | https://www.halooglasi.com/nekretnine/prodaja-stanova/na-prodaju-dvosoban-stan-na-zlatiboru/5425647962257 | /nekretnine/prodaja-stanova/na-prodaju-dvosoban-stan-na-zlatiboru/5425647962257 | {2 fields} | {2 fields} | 49 | 3 | 2 | II | — | {5 fields} | owner | 11 | https://img.halooglasi.com/slike/oglasi/Thumbs/261110/m/na-prodaju-dvosoban-stan-na-zlatiboru-5425647962257-71817631853.jpg | 2026-11-10 | Prodajem dvosoban stan 49m2 na Zlatiboru kompletno opremljen. Stan se nalazi na 1km od centra, naselje Vranjevina. Stan posjeduje dnevni boravak,... | true | Recorded from our API · 3 items shown · 18 datapoints per item GET /v1/halo-oglasi/search?listing\_type=sale&property\_type=flat&min\_price=80000&max\_price=150000&sort=price\_asc 18 datapoints ### Identity - id string - title string - advertiser\_type string ### Contact - url url ### Location - area\_m2 integer - location object ### Reputation - image\_count integer ### Price - price object - price\_per\_m2 object ### Other - path string - rooms integer - floor integer - floor\_label string - total\_floors number - thumbnail url - published\_at string - short\_description string - has\_map\_position boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/halo-oglasi/search?listing_type=sale&property_type=flat&min_price=80000&max_price=150000&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` Halo Oglasi · 5 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/halo-oglasi/agency`](https://perceptlayer.com/apis/halo-oglasi/agency) | `route` | 1 credit | | [GET `/v1/halo-oglasi/agency-ads`](https://perceptlayer.com/apis/halo-oglasi/agency-ads) | `advertiser_id` +17 optional | 1 credit | | [GET `/v1/halo-oglasi/autocomplete`](https://perceptlayer.com/apis/halo-oglasi/autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/halo-oglasi/listing`](https://perceptlayer.com/apis/halo-oglasi/listing) | `url` | 1 credit | | [GET `/v1/halo-oglasi/search`](https://perceptlayer.com/apis/halo-oglasi/search) | none +17 optional | 1 credit | Overview ## About the Halo Oglasi API ## What you can get The Halo Oglasi API returns Serbian property data from Halo Oglasi as JSON through 5 endpoints. - **Search:** `search` takes a `listing_type` (sale or rent) and a `property_type` (flat, house, land, garage, shop, room or warehouse), with `min_price`, `max_price`, `min_area`, `max_area`, `min_rooms`, `max_rooms`, `advertiser_type` (owner, agency or investor), `building_type` (old or new), repeatable `location_ids[]`, `condition_ids[]`, `furnishing_ids[]`, `heating_ids[]` and `feature_ids[]`, `sort` (newest, oldest, price\_asc, price\_desc, area\_asc or area\_desc) and `page`. - **Listings:** `listing` takes a `url`. - **Agencies:** `agency` takes a `route`; `agency-ads` takes an `advertiser_id`, with the same filters as `search`. - **Locations:** `autocomplete` takes a `query`, with `limit`. The recorded `search` for flats for sale between 80,000 and 150,000 EUR, cheapest first, returns `data.items`, each with `id`, `title`, `url`, `path`, `price`, `price_per_m2`, `area_m2`, `rooms`, `floor`, `total_floors`, `location`, `advertiser_type`, `image_count`, `thumbnail`, `published_at` and `short_description`. It also returns `pagination` with `total_count` (4,490), `total_pages` and `has_next_page`, `applied_filters`, and `facets` for advertiser type, building type, condition, heating and features, each with the `filter_param` and `filter_value` to pass back to `search`. ## How a call works Search flats: `GET /v1/halo-oglasi/search?listing_type=sale&property_type=flat&min_price=80000&max_price=150000&sort=price_asc` with your key in the `X-API-Key` header. Each item's `path` goes to `listing` as `url`. Page with `page` while `has_next_page` is true. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices for flats in Beograd, Novi Sad and other Serbian cities `Use the Halo Oglasi API to track asking prices for flats in Beograd, Novi Sad and other Serbian cities` ### Compare \`price\_per\_m2\` between old and new buildings with \`building\_type\` `` Use the Halo Oglasi API to compare `price_per_m2` between old and new buildings with `building_type` `` ### Separate owner, agency and investor listings with \`advertiser\_type\` `` Use the Halo Oglasi API to separate owner, agency and investor listings with `advertiser_type` `` ### Follow one agency's ads with \`agency-ads\` `` Use the Halo Oglasi API to follow one agency's ads with `agency-ads` `` FAQ ## Questions **Do I need a Halo Oglasi account?** No. You call this Halo Oglasi API with your Perceptlayer key in the \`X-API-Key\` header, with no Halo Oglasi login. **How much does the Halo Oglasi API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **How do I filter by condition, heating or features?** Read the \`filter\_value\` IDs in a search's \`facets\`, then repeat the param its \`filter\_param\` names, such as \`condition\_ids\[\]\`, \`heating\_ids\[\]\` or \`feature\_ids\[\]\`, once per ID. **Should I build a Halo Oglasi scraper instead?** You can, but a Halo Oglasi scraper is code you maintain: page changes break it, requests get blocked, and Halo Oglasi's terms govern how you collect data. The Halo Oglasi API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Halo Oglasi API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)