imot.bg APIimot.bg ↗
Access Bulgarian property listings for sale and rent from imot.bg. Search by location, price, area, filter by property type, and retrieve average district prices.
curl -X GET 'https://api.parse.bot/scraper/fcccf2c5-b878-42f1-a63a-1d246dfba689/search_listings_for_sale?page=1&location=%D0%B3%D1%80%D0%B0%D0%B4+%D0%A1%D0%BE%D1%84%D0%B8%D1%8F&property_types=2-%D0%A1%D0%A2%D0%90%D0%95%D0%9D' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for property listings for sale on imot.bg with optional filters for location, price range, area, property type, and pagination. Returns a paginated list of matching listings.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| currency | string | Currency for prices. Accepted values: EUR, USD. |
| location | string | Location filter in Bulgarian (e.g. 'град София', 'Пловдив'). |
| max_area | integer | Maximum area in square meters. |
| min_area | integer | Minimum area in square meters. |
| max_price | integer | Maximum price in the specified currency. |
| min_price | integer | Minimum price in the specified currency. |
| sort_order | integer | Sort order. Accepted values: 2 (newest first). |
| property_types | string | Comma-separated property type names in Bulgarian. Accepted values: 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, АТЕЛИЕ/ТАВАН, ОФИС, МАГАЗИН, ЗАВЕДЕНИЕ, СКЛАД, ХОТЕЛ, ПРОМ.ПОМЕЩЕНИЕ, ЕТАЖ ОТ КЪЩА, КЪЩА, ВИЛА, ПАРЦЕЛ, ГАРАЖ/ПАРКОМЯСТО, ЗЕМЕДЕЛСКА ЗЕМЯ, БИЗНЕС ИМОТ. |
{
"type": "object",
"fields": {
"page": "current page number as string",
"count": "integer total number of listings on this page",
"listings": "array of listing objects with id, title, url, price, info"
},
"sample": {
"data": {
"page": "1",
"count": 41,
"listings": [
{
"id": "1j177694810430050",
"url": "https://www.imot.bg/obiava-1j177694810430050-prodava-kashta-grad-sofiya-simeonovo",
"info": "605 кв.м, двор 1038 кв.м",
"price": "700 000 €1 369 081.00 лв.",
"title": "Продава КЪЩАград София, Симеоново"
}
]
},
"status": "success"
}
}About the imot.bg API
The imot.bg API exposes 5 endpoints for querying Bulgarian real estate data: sale and rental listing search, full listing details, district-level average prices, and search form options. The get_listing_details endpoint returns price in EUR and BGN, photos, construction parameters, price per square meter, and a contact phone number. Location filters accept Bulgarian city names, making the API a direct match for Bulgarian-language property data workflows.
Search Listings for Sale and Rent
The search_listings_for_sale and search_listings_for_rent endpoints accept overlapping filter sets: location (Bulgarian city name such as град София), min_price/max_price, min_area/max_area, currency (EUR or USD), and page for pagination. The rental endpoint adds a property_types parameter that accepts comma-separated Bulgarian apartment size labels (1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТ). Both endpoints return a count of listings on the current page and an array of listing objects with id, title, url, price, and info. The sort_order parameter on the sale endpoint accepts 2 to sort newest first.
Listing Details and Pricing Data
get_listing_details accepts either a full url from search results or a listing_id string. The response includes the listing title, description, price (in both EUR and BGN), price_per_sqm, price_info (e.g. VAT status), a parameters object covering area, yard size, and construction type, an array of photos URLs, and a phone number. This is the only endpoint that returns contact information and full photo sets.
Average Prices and Filter Options
get_average_prices takes a Bulgarian city name (town) and a four-digit year string and returns an array of district-level objects, each containing a district name and a prices array. This is useful for benchmarking individual listing prices against neighborhood-level market data. The get_search_form_options endpoint requires no inputs and returns the current list of valid property_types strings in Bulgarian, which can be passed directly into search filters.
- Aggregate sale and rental listings in Sofia or Plovdiv by filtering on location, price range, and area for a property search portal.
- Monitor new property listings by sorting
search_listings_for_saleby newest first and polling periodically. - Pull full listing details via
get_listing_detailsto populate a property comparison tool with photos, construction type, and price per sqm. - Compare district-level average prices from
get_average_pricesagainst individual listing prices to flag under- or over-priced properties. - Build a Bulgarian rental apartment finder using
search_listings_for_rentfiltered by property type labels like2-СТАЕНor3-СТАЕН. - Validate property type filter strings before search by calling
get_search_form_optionsto retrieve the current accepted values.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does imot.bg offer an official developer API?+
What does `get_listing_details` return beyond what search results include?+
get_listing_details returns fields not present in search result objects: a contact phone number, an array of full-resolution photos URLs, a parameters object with area, yard size, and construction type, price_per_sqm, price_info indicating VAT status, and the full description text. Search results return only id, title, url, price, and info.How does pagination work across the search endpoints?+
search_listings_for_sale and search_listings_for_rent accept an integer page parameter. Each response includes a page field (returned as a string) and a count of listings on that page. There is no total_pages or total_count field in the response, so you need to increment page until count drops to zero or a page returns fewer results than expected.Does the API cover properties outside Bulgaria or in English?+
град София, Пловдив), and property type values are Bulgarian strings. No English-language or non-Bulgarian listings are returned. You can fork this API on Parse and revise it to add transliteration or translation handling if your workflow requires Latin-script inputs.