Sign inGet a free API keyDashboard
Menu

APIs / Real estate / imot.bg

1 credit per call5 endpoints18 datapoints

imot.bg API

imot.bg API for Bulgarian property listings for sale or rent, listing details, agencies and location autocomplete as JSON. 1 credit per successful call.

Get a free API keyRun it below
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.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idstringurlurltitlestringdeal_typestringproperty_typestringlocationstringpriceobjectprice_textstringarea_sqmintegerfloorobjectyear_builtintegersummarystringphonestringpromotionstring[]photosstring[]photo_countintegeragencyobjectis_private_sellerboolean
11b178820194315234https://www.imot.bg/obiava-1b178820194315234-prodava-dvustaen-apartament-grad-sofiya-borovoПродава 2-СТАЕНsale2-СТАЕНград София, Борово{2 fields}168 000 €60{3 fields}197960 кв.м, 2-ри ет. от 6, ТЕЦ, Въведен в експлоатация 1970 - 1979 г., Двустаен апартамент с отделна кухня. Жилището се намира на комуникативно място до пазара Борово, в б ...0882508388[1 item][3 items]17{5 fields}false
21b179301866728020https://www.imot.bg/obiava-1b179301866728020-prodava-dvustaen-apartament-grad-sofiya-slatina-ul-hanovoПродава 2-СТАЕНsale2-СТАЕНград София, Слатина{2 fields}149 000 €70{3 fields}202770 кв.м, ул. Ханово, 5-ти ет. от 6, Ще бъде въведен в експлоатация 2027 г., SHALIMAR VIEW СОФИЯ, КВ. СЛАТИНА ДВУСТАЕН АПАРТАМЕНТ 52 69,91 м? С ВЛЯЗЛО В СИЛА РАЗРЕШЕНИЕ З ...0877744414[1 item][3 items]7—true
31b176917718949726https://www.imot.bg/obiava-1b176917718949726-prodava-dvustaen-apartament-grad-sofiya-banishoraПродава 2-СТАЕНsale2-СТАЕНград София, Банишора{2 fields}129 260 €70{3 fields}202870 кв.м, 3-ти ет. от 16, Ще бъде въведен в експлоатация 2028 г., Двустайно жилище с гледка | В процес на Строителство | Без комисионна Застроена площ: 55,03 кв.м; О ...070070095[1 item][3 items]6{5 fields}false

Recorded from our API · 3 items shown · 18 datapoints per itemGET /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

18 datapoints

Identity

  • idstring
  • titlestring
  • property_typestring

Contact

  • urlurl
  • phonestring
  • is_private_sellerboolean

Location

  • locationstring
  • area_sqminteger

Reputation

  • photosstring[]
  • photo_countinteger

Price

  • deal_typestring
  • priceobject
  • price_textstring

Other

  • floorobject
  • year_builtinteger
  • summarystring
  • promotionstring[]
  • agencyobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/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" \
  -H "X-API-Key: $API_KEY"

imot.bg · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/imot-bg/agencies
none+2 optional
1 credit
GET/v1/imot-bg/agency
agency+2 optional
1 credit
GET/v1/imot-bg/autocomplete
query+1 optional
1 credit
GET/v1/imot-bg/listing
none+2 optional
1 credit
GET/v1/imot-bg/search
none+11 optional
1 credit

Overview

What you can get

The imot.bg API returns imot.bg property data as JSON through 5 endpoints.

  • Search: search takes a location or location_id, with deal (sale or rent), property_type (ednostaen, dvustaen, tristaen, chetiristaen, mnogostaen, mezonet, kashta, vila, ofis, magazin, partsel, garazh-parkomyasto and more), bedrooms, min_price, max_price, min_area, max_area, sort (newest, price_asc, price_per_sqm_asc or newest_3_days) and page.
  • Listings: listing takes an id or a listing url.
  • Agencies: agencies takes an optional query and sort (listings or alphabetical); agency takes an agency, with deal (sale or rent) and page.
  • Locations: autocomplete takes a query, with limit.

The recorded search for София (sale, 2 bedrooms, 100,000 to 200,000) returns items, each with id, url, title, deal_type, property_type, location, price, price_text, area_sqm, floor, year_built, summary, photo_count, agency and is_private_seller. It also returns the resolved location with its location_id, the applied_filters (with currency), and pagination with per_page, total_pages, has_next and a result_cap of 1,000 results per search.

How a call works

Search a city: GET /v1/imot-bg/search?location=София&deal=sale&bedrooms=2&min_price=100000&max_price=200000 with your key in the X-API-Key header. Each item carries an id, the parameter listing takes, and an agency object whose id goes to agency as the agency parameter. Page with page while has_next is true. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices for apartments in Sofia and other Bulgarian cities

Use the imot.bg API to track asking prices for apartments in Sofia and other Bulgarian cities

Compare price per square metre across districts with `price_per_sqm_asc`

Use the imot.bg API to compare price per square metre across districts with `price_per_sqm_asc`

Watch new listings from the last three days with `newest_3_days`

Use the imot.bg API to watch new listings from the last three days with `newest_3_days`

Rank agencies by listing count with `agencies` and `sort=listings`

Use the imot.bg API to rank agencies by listing count with `agencies` and `sort=listings`

FAQ

Questions

How much does the imot.bg 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.

Do I need an imot.bg account?

No. You call this imot.bg API with your Perceptlayer key in the `X-API-Key` header, with no imot.bg login.

How many results can one search return?

The recorded search reports a `result_cap` of 1,000, over 25 pages of 40. Narrow the `location`, price or area to see past it.

Should I build an imot.bg scraper instead?

You can, but an imot.bg scraper is code you maintain: page changes break it, requests get blocked, and imot.bg's terms govern how you collect data. The imot.bg 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 imot.bg API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs