APIs / imot.bg / Search

imot.bg: Search

Search from imot.bg as JSON. 1 credit per successful call.

GET /v1/imot-bg/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
locationstringOptionalUp to 100 characters
location_idstringOptionalUp to 120 characters
dealstringOptionalsale, rent
property_typestringOptionalednostaen, dvustaen, tristaen, chetiristaen, mnogostaen, mezonet, atelie-tavan, ofis, magazin, zavedenie, sklad, hotel, promishleno-pomeshtenie, biznes-imot, etazh-ot-kashta, kashta, vila, garazh-parkomyasto, zemedelska-zemya, partsel, staya, myasto
bedroomsintegerOptionalAny
min_priceintegerOptionalAny
max_priceintegerOptionalAny
min_areaintegerOptionalAny
max_areaintegerOptionalAny
sortstringOptionalnewest, price_asc, price_per_sqm_asc, newest_3_days
pageintegerOptionalAny

Example request

imot.bg
GET/v1/imot-bg/search?location=%D0%A1%D0%BE%D1%84%D0%B8%D1%8F&deal=sale&bedrooms=2&min_price=100000&max_price=200000
{
  "success": true,
  "data": {
    "location": {
      "name": "София",
      "location_id": "град София~"
    },
    "applied_filters": {
      "deal": "sale",
      "property_type": "dvustaen",
      "bedrooms": "2",
      "min_price": "100000",
      "max_price": "200000",
      "currency": "EUR",
      "page": 1
    },
    "pagination": {
      "page": 1,
      "per_page": 40,
      "total_results": 1000,
      "total_results_is_lower_bound": true,
      "total_pages": 25,
      "has_next": true,
      "result_cap": 1000,
      "filtered_out": 0
    },
    "items": [
      {
        "id": "1b178820194315234",
        "url": "https://www.imot.bg/obiava-1b178820194315234-prodava-dvustaen-apartament-grad-sofiya-borovo",
        "title": "Продава 2-СТАЕН",
        "deal_type": "sale",
        "property_type": "2-СТАЕН",
        "location": "град София, Борово",
        "price": {
          "amount": 168000,
          "currency": "EUR"
        },
        "price_text": "168 000 €",
        "area_sqm": 60,
        "floor": {
          "number": 2,
          "total": 6,
          "label": "2-ри ет. от 6"
        },
        "year_built": 1979,
        "summary": "60 кв.м, 2-ри ет. от 6, ТЕЦ, Въведен в експлоатация 1970 - 1979 г., Двустаен апартамент с отделна кухня. Жилището се намира на комуникативно място до пазара Борово, в б ...",
        "phone": "0882508388",
        "promotion": [
          "BEST"
        ],
        "photos": [
          "https://imotstatic2.focus.bg/imot/photosimotbg/1/234/1b178820194315234_mc.jpg",
          "https://imotstatic2.focus.bg/imot/photosimotbg/1/234/1b178820194315234_HU.jpg",
          "https://imotstatic2.focus.bg/imot/photosimotbg/1/234/1b178820194315234_oF.jpg"
        ],
        "photo_count": 17,
        "agency": {
          "id": "arete",
          "name": "АРЕТЕ-2000 ООД",
          "url": "https://arete.imot.bg",
          "logo": "https://www.imot.bg/images/logos/med/arete.pic",
          "address": "ул.Абоба 1, ет.6, ап.15"
        },
        "is_private_seller": false
      },
      {
        "id": "1b179301866728020",
        "url": "https://www.imot.bg/obiava-1b179301866728020-prodava-dvustaen-apartament-grad-sofiya-slatina-ul-hanovo",
        "title": "Продава 2-СТАЕН",
        "deal_type": "sale",
        "property_type": "2-СТАЕН",
        "location": "град София, Слатина",
        "price": {
          "amount": 149000,
          "currency": "EUR"
        },
        "price_text": "149 000 €",
        "area_sqm": 70,
        "floor": {
          "number": 5,
          "total": 6,
          "label": "5-ти ет. от 6"
        },
        "year_built": 2027,
        "summary": "70 кв.м, ул. Ханово, 5-ти ет. от 6, Ще бъде въведен в експлоатация 2027 г., SHALIMAR VIEW СОФИЯ, КВ. СЛАТИНА ДВУСТАЕН АПАРТАМЕНТ 52 69,91 м? С ВЛЯЗЛО В СИЛА РАЗРЕШЕНИЕ З ...",
        "phone": "0877744414",
        "promotion": [
          "BEST"
        ],
        "photos": [
          "https://imotstatic1.focus.bg/imot/photosimotbg/1/020/1b179301866728020_44.jpg",
          "https://imotstatic1.focus.bg/imot/photosimotbg/1/020/1b179301866728020_k5.jpg",
          "https://imotstatic1.focus.bg/imot/photosimotbg/1/020/1b179301866728020_ot.jpg"
        ],
        "photo_count": 7,
        "is_private_seller": true
      },
      {
        "id": "1b176917718949726",
        "url": "https://www.imot.bg/obiava-1b176917718949726-prodava-dvustaen-apartament-grad-sofiya-banishora",
        "title": "Продава 2-СТАЕН",
        "deal_type": "sale",
        "property_type": "2-СТАЕН",
        "location": "град София, Банишора",
        "price": {
          "amount": 129260,
          "currency": "EUR"
        },
        "price_text": "129 260 €",
        "area_sqm": 70,
        "floor": {
          "number": 3,
          "total": 16,
          "label": "3-ти ет. от 16"
        },
        "year_built": 2028,
        "summary": "70 кв.м, 3-ти ет. от 16, Ще бъде въведен в експлоатация 2028 г., Двустайно жилище с гледка | В процес на Строителство | Без комисионна Застроена площ: 55,03 кв.м; О ...",
        "phone": "070070095",
        "promotion": [
          "TOP"
        ],
        "photos": [
          "https://imotstatic3.focus.bg/imot/photosimotbg/1/726/1b176917718949726_SI.jpg",
          "https://imotstatic3.focus.bg/imot/photosimotbg/1/726/1b176917718949726_7.jpg",
          "https://imotstatic3.focus.bg/imot/photosimotbg/1/726/1b176917718949726_Wc.jpg"
        ],
        "photo_count": 6,
        "agency": {
          "id": "infinity",
          "name": "ИНФИНИТИ ПРОПЪРТИ EООД",
          "url": "https://infinity.imot.bg",
          "logo": "https://www.imot.bg/images/logos/med/infinity.pic",
          "address": "ул. 'Силистра' 10"
        },
        "is_private_seller": false
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_324eaf9b323241ba9a60d946f18f4706",
    "credits_charged": 1,
    "credits_remaining": 1796
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.