--- title: "imot.bg API: JSON data, 5 endpoints, 1 credit per call" description: "imot.bg API for Bulgarian property listings for sale or rent, listing details, agencies and location autocomplete as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/imot-bg --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / imot.bg 1 credit per call 5 endpoints 18 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 key](https://perceptlayer.com/signup) Run 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 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 | url url | title string | deal\_type string | property\_type string | location string | price object | price\_text string | area\_sqm integer | floor object | year\_built integer | summary string | phone string | promotion string\[\] | photos string\[\] | photo\_count integer | agency object | is\_private\_seller boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1b178820194315234 | https://www.imot.bg/obiava-1b178820194315234-prodava-dvustaen-apartament-grad-sofiya-borovo | Продава 2-СТАЕН | sale | 2-СТАЕН | град София, Борово | {2 fields} | 168 000 € | 60 | {3 fields} | 1979 | 60 кв.м, 2-ри ет. от 6, ТЕЦ, Въведен в експлоатация 1970 - 1979 г., Двустаен апартамент с отделна кухня. Жилището се намира на комуникативно място до пазара Борово, в б ... | 0882508388 | \[1 item\] | \[3 items\] | 17 | {5 fields} | false | | 2 | 1b179301866728020 | https://www.imot.bg/obiava-1b179301866728020-prodava-dvustaen-apartament-grad-sofiya-slatina-ul-hanovo | Продава 2-СТАЕН | sale | 2-СТАЕН | град София, Слатина | {2 fields} | 149 000 € | 70 | {3 fields} | 2027 | 70 кв.м, ул. Ханово, 5-ти ет. от 6, Ще бъде въведен в експлоатация 2027 г., SHALIMAR VIEW СОФИЯ, КВ. СЛАТИНА ДВУСТАЕН АПАРТАМЕНТ 52 69,91 м? С ВЛЯЗЛО В СИЛА РАЗРЕШЕНИЕ З ... | 0877744414 | \[1 item\] | \[3 items\] | 7 | — | true | | 3 | 1b176917718949726 | https://www.imot.bg/obiava-1b176917718949726-prodava-dvustaen-apartament-grad-sofiya-banishora | Продава 2-СТАЕН | sale | 2-СТАЕН | град София, Банишора | {2 fields} | 129 260 € | 70 | {3 fields} | 2028 | 70 кв.м, 3-ти ет. от 16, Ще бъде въведен в експлоатация 2028 г., Двустайно жилище с гледка \| В процес на Строителство \| Без комисионна Застроена площ: 55,03 кв.м; О ... | 070070095 | \[1 item\] | \[3 items\] | 6 | {5 fields} | false | Recorded from our API · 3 items shown · 18 datapoints per item 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 18 datapoints ### Identity - id string - title string - property\_type string ### Contact - url url - phone string - is\_private\_seller boolean ### Location - location string - area\_sqm integer ### Reputation - photos string\[\] - photo\_count integer ### Price - deal\_type string - price object - price\_text string ### Other - floor object - year\_built integer - summary string - promotion string\[\] - agency object Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/imot-bg/agencies`](https://perceptlayer.com/apis/imot-bg/agencies) | none +2 optional | 1 credit | | [GET `/v1/imot-bg/agency`](https://perceptlayer.com/apis/imot-bg/agency) | `agency` +2 optional | 1 credit | | [GET `/v1/imot-bg/autocomplete`](https://perceptlayer.com/apis/imot-bg/autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/imot-bg/listing`](https://perceptlayer.com/apis/imot-bg/listing) | none +2 optional | 1 credit | | [GET `/v1/imot-bg/search`](https://perceptlayer.com/apis/imot-bg/search) | none +11 optional | 1 credit | Overview ## About the imot.bg API ## 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 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 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)