APIs / Real estate / Halo Oglasi
1 credit per call5 endpoints18 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.
{
"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
}
}Sample data
What one call returns
A recorded run of search: the fields and shapes you will get, shortened to 3 items.
| # | idstring | titlestring | urlurl | pathstring | priceobject | price_per_m2object | area_m2integer | roomsinteger | floorinteger | floor_labelstring | total_floorsnumber | locationobject | advertiser_typestring | image_countinteger | thumbnailurl | published_atstring | short_descriptionstring | has_map_positionboolean |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
[
{
"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
}
]id,title,url,path,price,price_per_m2,area_m2,rooms,floor,floor_label,total_floors,location,advertiser_type,image_count,thumbnail,published_at,short_description,has_map_position
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,"{""amount"":80000,""currency"":""EUR""}","{""amount"":4211,""currency"":""EUR""}",19,1,0,VPR,7,"{""city"":""Beograd"",""area"":""Opština Zvezdara"",""micro_location"":""Mirijevo"",""street"":""Vladislava Bajčevića"",""places"":[""Beograd"",""Opština Zvezdara"",""Mirijevo""]}",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
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,"{""amount"":80028,""currency"":""EUR""}","{""amount"":1455,""currency"":""EUR""}",55,2,1,I,2,"{""city"":""Valjevo"",""area"":""Okolno mesto"",""micro_location"":""Divčibare"",""street"":""Valjevska"",""places"":[""Valjevo"",""Okolno mesto"",""Divčibare""]}",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
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,"{""amount"":80850,""currency"":""EUR""}","{""amount"":1650,""currency"":""EUR""}",49,3,2,II,,"{""city"":""Zlatibor"",""area"":""Okolno mesto"",""micro_location"":""Čolovića brdo"",""street"":""Vranjevina"",""places"":[""Zlatibor"",""Okolno mesto"",""Čolovića brdo""]}",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,...",trueRecorded from our API · 3 items shown · 18 datapoints per itemGET /v1/halo-oglasi/search?listing_type=sale&property_type=flat&min_price=80000&max_price=150000&sort=price_asc
18 datapoints
Identity
- idstring
- titlestring
- advertiser_typestring
Contact
- urlurl
Location
- area_m2integer
- locationobject
Reputation
- image_countinteger
Price
- priceobject
- price_per_m2object
Other
- pathstring
- roomsinteger
- floorinteger
- floor_labelstring
- total_floorsnumber
- thumbnailurl
- published_atstring
- short_descriptionstring
- has_map_positionboolean
Playground
Run this API
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 | route | 1 credit |
GET/v1/halo-oglasi/agency-ads | advertiser_id+17 optional | 1 credit |
GET/v1/halo-oglasi/autocomplete | query+1 optional | 1 credit |
GET/v1/halo-oglasi/listing | url | 1 credit |
GET/v1/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:
searchtakes alisting_type(sale or rent) and aproperty_type(flat, house, land, garage, shop, room or warehouse), withmin_price,max_price,min_area,max_area,min_rooms,max_rooms,advertiser_type(owner, agency or investor),building_type(old or new), repeatablelocation_ids[],condition_ids[],furnishing_ids[],heating_ids[]andfeature_ids[],sort(newest, oldest, price_asc, price_desc, area_asc or area_desc) andpage. - Listings:
listingtakes aurl. - Agencies:
agencytakes aroute;agency-adstakes anadvertiser_id, with the same filters assearch. - Locations:
autocompletetakes aquery, withlimit.
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.
More real estate APIs
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 citiesCompare `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.