# Imot — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search real estate listings for sale or rent on Bulgaria's imot.bg marketplace, view detailed property information, and compare average prices to make informed decisions. Access search filters and options to refine your property search by location, price, and other criteria.

**Category:** Real Estate | **Website:** [imot.bg/](https://imot.bg/) | **Docs:** [parse.bot/marketplace/5e6586c0-6494-41b7-84e8-cb4f58a7fa89/imot-bg-api](https://parse.bot/marketplace/5e6586c0-6494-41b7-84e8-cb4f58a7fa89/imot-bg-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-imot-bg-api-5e6586c0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_average_prices

Get average property prices by district for a Bulgarian city. Returns price data per district for the specified year. Prices are in EUR per square meter. Data comes from imot.bg's statistical aggregation page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `town` | string | No | City name in Bulgarian (e.g. 'София', 'Пловдив'). |
| `year` | string | No | Year for price data as a 4-digit string (e.g. '2024', '2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imot-bg-api-5e6586c0/get_average_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"town":"<string>","year":"<string>"}'
```

### get_listing_details

Get full details of a single property listing including price, parameters (area, floor, construction type), description text, photo URLs, and contact phone. Either url or listing_id must be provided. listing_id values come from search_listings_for_sale or search_listings_for_rent results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | No | Listing ID from search results (e.g. '1a177764345916850'). Used to construct the URL if url is not provided. |
| `url` | string | No | Full listing URL from imot.bg (e.g. from search results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imot-bg-api-5e6586c0/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>","url":"<string>"}'
```

### get_search_form_options

Get available property types for search filters. Returns the list of property type names that can be used in search_listings_for_sale and search_listings_for_rent property_types parameter. Useful to discover valid filter values before searching.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imot-bg-api-5e6586c0/get_search_form_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_listings_for_rent

Search for property listings for rent on imot.bg. Supports filtering by location, price range, area, and property type. Returns a paginated list of matching rental listings. Each listing includes an id usable with get_listing_details for full property information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Currency for prices. |
| `location` | string | No | Location filter in Bulgarian (e.g. 'град София', 'Пловдив'). |
| `max_area` | integer | No | Maximum area in square meters. |
| `max_price` | integer | No | Maximum price in the specified currency. |
| `min_area` | integer | No | Minimum area in square meters. |
| `min_price` | integer | No | Minimum price in the specified currency. |
| `page` | integer | No | Page number for pagination. |
| `property_types` | string | No | Comma-separated property type names in Bulgarian. Accepted values: 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, АТЕЛИЕ/ТАВАН, ОФИС, МАГАЗИН, ЗАВЕДЕНИЕ, СКЛАД, ХОТЕЛ, ПРОМ.ПОМЕЩЕНИЕ, ЕТАЖ ОТ КЪЩА, КЪЩА, ВИЛА, ПАРЦЕЛ, ГАРАЖ/ПАРКОМЯСТО, ЗЕМЕДЕЛСКА ЗЕМЯ, БИЗНЕС ИМОТ. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imot-bg-api-5e6586c0/search_listings_for_rent \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","location":"<string>","max_area":"<integer>","max_price":"<integer>","min_area":"<integer>","min_price":"<integer>","page":"<integer>","property_types":"<string>"}'
```

### search_listings_for_sale

Search for property listings for sale on imot.bg. Supports filtering by location, price range, area, property type, and pagination. Returns a paginated list of matching listings sorted by newest first by default. Each listing includes an id usable with get_listing_details for full property information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Currency for prices. |
| `location` | string | No | Location filter in Bulgarian (e.g. 'град София', 'Пловдив'). |
| `max_area` | integer | No | Maximum area in square meters. |
| `max_price` | integer | No | Maximum price in the specified currency. |
| `min_area` | integer | No | Minimum area in square meters. |
| `min_price` | integer | No | Minimum price in the specified currency. |
| `page` | integer | No | Page number for pagination. |
| `property_types` | string | No | Comma-separated property type names in Bulgarian. Accepted values: 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, АТЕЛИЕ/ТАВАН, ОФИС, МАГАЗИН, ЗАВЕДЕНИЕ, СКЛАД, ХОТЕЛ, ПРОМ.ПОМЕЩЕНИЕ, ЕТАЖ ОТ КЪЩА, КЪЩА, ВИЛА, ПАРЦЕЛ, ГАРАЖ/ПАРКОМЯСТО, ЗЕМЕДЕЛСКА ЗЕМЯ, БИЗНЕС ИМОТ. |
| `sort_order` | integer | No | Sort order for results. 2 = newest first. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imot-bg-api-5e6586c0/search_listings_for_sale \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","location":"<string>","max_area":"<integer>","max_price":"<integer>","min_area":"<integer>","min_price":"<integer>","page":"<integer>","property_types":"<string>","sort_order":"<integer>"}'
```