# Immobiliare — 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 Italian property listings for sale or rent, browse real estate agencies, and explore price trends across Italian cities — all via immobiliare.it.

**Category:** Real Estate | **Website:** [immobiliare.it/](https://immobiliare.it/) | **Docs:** [parse.bot/marketplace/54622601-501a-4323-ba69-9ac142fb8a5c/immobiliare-it-api](https://parse.bot/marketplace/54622601-501a-4323-ba69-9ac142fb8a5c/immobiliare-it-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-immobiliare-it-api-54622601/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_agency_detail

Get full details of a real estate agency by ID. Returns agency information including agents list, contact details, opening hours, location, description, website, and number of active listings. Agency IDs can be obtained from search_agencies results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `agency_id` | string | Yes | Agency ID (numeric string from search_agencies results, e.g., '100278') |
| `slug` | string | No | Agency URL slug (e.g., 'gruppo-rezza-roma'). Optional, improves URL routing. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-immobiliare-it-api-54622601/get_agency_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agency_id":"<string>","slug":"<string>"}'
```

### get_location_autocomplete

Search for locations (cities, regions, zones) by query to get location keys for use in other endpoints. Returns an array of matching locations with geographic hierarchy, center coordinates, and parent regions. The keyurl field is used as location_key in search_properties and search_agencies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Location search query (e.g., 'Roma', 'Milano', 'Firenze') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-immobiliare-it-api-54622601/get_location_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_price_trends

Get property price trend data and market statistics for a city. Returns average prices per square meter for sale and rent, price charts over time, zone-level breakdowns with trend percentages, and listing counts. Region and city keys can be obtained from get_location_autocomplete (parents array for region, keyurl for city).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_key` | string | Yes | City key (e.g., 'Roma', 'Milano', 'Firenze') |
| `region_key` | string | Yes | Region key (e.g., 'Lazio', 'Lombardia', 'Toscana') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-immobiliare-it-api-54622601/get_price_trends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_key":"<string>","region_key":"<string>"}'
```

### get_property_detail

Get full details of a specific property listing by ID. Returns comprehensive property information including description, photos, location, energy class, floor plans, price history, mortgage information, and advertiser details. Listing IDs can be obtained from search_properties results (realEstate.id field).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | Property listing ID (numeric string from search_properties results, e.g., '128500002') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-immobiliare-it-api-54622601/get_property_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>"}'
```

### search_agencies

Search real estate agencies in a location. Returns paginated agency listings with contact information, quality metrics, badge level, active listing counts, and partnership affiliations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location_key` | string | Yes | Location key from autocomplete endpoint keyurl field (e.g., 'Roma', 'Milano') |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-immobiliare-it-api-54622601/search_agencies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_key":"<string>","page":"<integer>"}'
```

### search_properties

Search properties for sale or rent by location. Uses location keys from the get_location_autocomplete endpoint (keyurl field). Returns paginated property listings with details including price, rooms, surface area, and location. Resolves the location key to an internal ID before searching.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Property category |
| `contract` | string | No | Contract type |
| `location_key` | string | Yes | Location key from autocomplete endpoint keyurl field (e.g., 'Roma', 'Milano', 'Firenze') |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-immobiliare-it-api-54622601/search_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","contract":"<string>","location_key":"<string>","page":"<integer>"}'
```