# Portalinmobiliario — 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 analyze property listings from Chile's top real estate platform, accessing detailed information like prices in UF or CLP, room and bathroom counts, square footage, and locations for apartments, houses, and other properties. Quickly compare available properties and gather market data to find your ideal home or investment opportunity.

**Category:** Real Estate | **Website:** [www.portalinmobiliario.com/venta/departamento/vitacura-metropolitana](https://www.portalinmobiliario.com/venta/departamento/vitacura-metropolitana) | **Docs:** [parse.bot/marketplace/3b95d759-4b61-461d-be36-f3205ac649f0/portalinmobiliario-com-api](https://parse.bot/marketplace/3b95d759-4b61-461d-be36-f3205ac649f0/portalinmobiliario-com-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/portalinmobiliario/`
**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 listing detail

Get detailed information for a specific property listing including price, attributes, rooms, bathrooms, area, and location. Requires either a listing_url (from search results) or a listing_id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | No | MLC listing ID (e.g., MLC-1234567890). Either listing_url or listing_id is required. |
| `listing_url` | string | No | Full URL of the listing from search results (e.g., https://portalinmobiliario.com/MLC-1234567890-property-name_JM). Either listing_url or listing_id is required. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/portalinmobiliario/get-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>","listing_url":"<string>"}'
```

### Search listings

Search property listings by type, operation, and location. Returns up to 48 listings per page with price, rooms, bathrooms, area, and location information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location slug (e.g., vitacura-metropolitana, santiago-metropolitana, las-condes-metropolitana, providencia-metropolitana) |
| `operation` | string | No | Operation type: venta (sale) or arriendo (rent) |
| `page` | integer | No | Page number (1-based). Each page returns up to 48 listings. |
| `property_type` | string | No | Property type slug: departamento, casa, oficina, terreno, local-comercial |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/portalinmobiliario/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","operation":"<string>","page":"<integer>","property_type":"<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.