# Tecnocasa — 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 browse properties listed on Tecnocasa.it — Italy's largest real estate franchising network. Retrieve detailed property information including specifications, photos, pricing, and energy data. Look up agency contact details and use location autocomplete to refine searches by province, region, or city across Italy.

**Category:** Real Estate | **Website:** [tecnocasa.it/](https://tecnocasa.it/) | **Docs:** [parse.bot/marketplace/0872823f-4206-4f10-b514-55cc554c11bb/tecnocasa-it-api](https://parse.bot/marketplace/0872823f-4206-4f10-b514-55cc554c11bb/tecnocasa-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-tecnocasa-it-api-0872823f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_agency_details

Retrieve details for a specific Tecnocasa agency including contact info, address, coordinates, team members, and social media links. The url parameter must be a full tecnocasa.it agency page URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full agency URL on tecnocasa.it (e.g., 'https://www.tecnocasa.it/agenzie/immobiliari+residenziali/firenze/firenze/ficsd.html'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tecnocasa-it-api-0872823f/get_agency_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_location_autocomplete

Get location autocomplete suggestions for search input. Returns matching provinces, cities, and districts that can be used to refine property searches. Results include the location type and identifier.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query for location autocomplete (e.g., 'Roma', 'Milano', 'Tren'). |

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

### get_property_details

Retrieve full details for a specific property listing including description, features, photos, agency info, energy data, points of interest, and mortgage data. The url parameter must be a full tecnocasa.it property page URL (obtainable from search_properties results via the detail_url field).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full property URL on tecnocasa.it (e.g., 'https://www.tecnocasa.it/vendita/appartamenti/milano/settimo-milanese/61233362.html'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tecnocasa-it-api-0872823f/get_property_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_properties

Search for properties available for sale or rent by location (province/region). Returns paginated results with property summaries including price, surface area, rooms, and detail URLs. Each result includes a detail_url that can be passed to get_property_details for the full listing. The upstream API returns a total field but it is always 0 regardless of actual result count; use the estates array length to determine how many results were returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contract` | string | No | Contract type: 'acquis' for sale, 'affitto' for rent. |
| `limit` | integer | No | Results per page. |
| `max_price` | integer | No | Maximum price filter in euros. |
| `min_price` | integer | No | Minimum price filter in euros. |
| `page` | integer | No | Page number for pagination. |
| `province` | string | No | Province code (e.g., 'TN', 'MI', 'RM', 'FI', 'BZ'). |
| `region` | string | No | Region code (e.g., 'taa' for Trentino Alto Adige, 'lom' for Lombardia, 'vda' for Valle d'Aosta, 'ven' for Veneto, 'tos' for Toscana, 'laz' for Lazio). |
| `typology` | string | No | Property typology filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tecnocasa-it-api-0872823f/search_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contract":"<string>","limit":"<integer>","max_price":"<integer>","min_price":"<integer>","page":"<integer>","province":"<string>","region":"<string>","typology":"<string>"}'
```