# Imobiliare — 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 and filter rental apartments across Romania by city, zone, and price range using real-time listings from imobiliare.ro. Discover available properties that match your budget and location preferences with detailed filtering options.

**Category:** Real Estate | **Website:** [www.imobiliare.ro/](https://www.imobiliare.ro/) | **Docs:** [parse.bot/marketplace/34cc429b-f82e-4ed4-b3f4-382f5920cc96/imobiliare-ro-api](https://parse.bot/marketplace/34cc429b-f82e-4ed4-b3f4-382f5920cc96/imobiliare-ro-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-imobiliare-ro-api-34cc429b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_apartments_for_rent

Search apartments for rent on imobiliare.ro with filtering by city, zone, and price range. Returns paginated listing results (30 per page) including price, location, rooms, seller type, and listing URL. The city parameter uses URL slugs (e.g. 'bucuresti', 'cluj-napoca', 'timisoara'). The optional zone parameter narrows results to a specific neighborhood (e.g. 'pipera', 'manastur', 'floreasca').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City URL slug for the search (e.g. 'bucuresti', 'cluj-napoca', 'timisoara', 'brasov'). Use search_locations to discover valid city slugs. |
| `max_price` | string | No | Maximum monthly rent price in EUR (e.g. '800'). |
| `min_price` | string | No | Minimum monthly rent price in EUR (e.g. '400'). |
| `page` | integer | No | Page number for pagination. Each page returns up to 30 results. |
| `zone` | string | No | Zone/neighborhood URL slug to filter results (e.g. 'pipera', 'manastur', 'floreasca'). Use search_locations to discover valid zone slugs for a city. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imobiliare-ro-api-34cc429b/search_apartments_for_rent \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","max_price":"<string>","min_price":"<string>","page":"<integer>","zone":"<string>"}'
```

### search_locations

Search for locations (counties, cities, zones, streets) by name. Returns matching locations organized by type, each with a location_id and listings_count. Use this to discover valid city and zone slugs for the search_apartments_for_rent endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Location name to search for (e.g. 'Cluj', 'Bucuresti', 'Pipera'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-imobiliare-ro-api-34cc429b/search_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```