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.

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 OKJSONX-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.

#idstringtitlestringurlurlpathstringpriceobjectprice_per_m2objectarea_m2integerroomsintegerfloorintegerfloor_labelstringtotal_floorsnumberlocationobjectadvertiser_typestringimage_countintegerthumbnailurlpublished_atstringshort_descriptionstringhas_map_positionboolean
15425646789451Mirijevski venac, 24m2 renoviran stan sa galerijomhttps://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}1910VPR7{5 fields}agency8https://img.halooglasi.com/slike/oglasi/Thumbs/260219/m/mirijevo-renoviran-stan-bez-ulaganja-id1187-5425646789451-71814765795.jpg2026-11-02Kondor 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
25425646660783Uknjižen stan - u sistemu rentiranja A12https://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}5521I2{5 fields}investor10https://img.halooglasi.com/slike/oglasi/Thumbs/260311/m/uknjizen-stan---u-sistemu-rentiranja-5425646660783-71815014747.jpg2026-10-30Prodajemo luksuzan stan na Divčibarama, spreman za useljenje odmah. Mogućnost opremanja stana prema slikama u oglasu (posebna ponuda). Objekat je...true
35425647962257Na 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}4932II—{5 fields}owner11https://img.halooglasi.com/slike/oglasi/Thumbs/261110/m/na-prodaju-dvosoban-stan-na-zlatiboru-5425647962257-71817631853.jpg2026-11-10Prodajem 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 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

cURLshell
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.

EndpointRequired parametersCost
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: 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 estateJSONRESTMCP

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 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.