# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/tecnocasa/`
**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 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/credits/tecnocasa/get-agency-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/tecnocasa/get-location-autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/tecnocasa/get-property-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/tecnocasa/search-properties \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"contract":"<string>","limit":"<integer>","max_price":"<integer>","min_price":"<integer>","page":"<integer>","province":"<string>","region":"<string>","typology":"<string>"}'
```

## Next steps

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