# Imot — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/imot/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/imot/get-average-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/imot/get-listing-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/imot/get-search-form-options \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/imot/search-listings-for-rent \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/imot/search-listings-for-sale \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.