# Coldwellbanker — 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.

> Access data from coldwellbanker.com.mx.

**Category:** Real Estate | **Website:** [coldwellbanker.com.mx/propiedades-busqueda?o=VENTA](https://coldwellbanker.com.mx/propiedades-busqueda?o=VENTA) | **Docs:** [parse.bot/marketplace/9ad731ad-6237-41f1-abb2-5eb4e7525919/coldwellbanker-com-mx-api](https://parse.bot/marketplace/9ad731ad-6237-41f1-abb2-5eb4e7525919/coldwellbanker-com-mx-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-coldwellbanker-com-mx-api-9ad731ad/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_property_detail

Get comprehensive detail for a single property by its ID. Returns full description, all images, pricing with negotiation details, general features, parking, finishes, amenities, condominium details, points of interest, visiting hours, property rules, agent/office contact information, geographic coordinates, listing URL, and operation type. The property_id is obtained from the list_properties endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `property_id` | string | Yes | The numeric property ID from list_properties results (e.g. '65611'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coldwellbanker-com-mx-api-9ad731ad/get_property_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"property_id":"<string>"}'
```

### list_properties

List properties from the Coldwell Banker Mexico database with pagination. Returns property summaries including title, type, address, pricing, dimensions, photos, and office info. Supports filtering by operation type (sale/rent), price range, and location. The total database contains thousands of properties; paginate with page/size to traverse the full set. Each page returns up to 50 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | Filter by municipality/city name (e.g. 'Puerto Vallarta', 'Álvaro Obregón'). |
| `operation` | string | No | Type of operation: VENTA (sale) or RENTA (rent). |
| `page` | integer | No | Zero-based page number for pagination. |
| `price_max` | number | No | Maximum price filter (in the property's listed currency). |
| `price_min` | number | No | Minimum price filter (in the property's listed currency). |
| `property_type_id` | integer | No | Filter by property type ID from the site's catalog. |
| `size` | integer | No | Number of results per page, max 50. |
| `state` | string | No | Filter by state name (e.g. 'Ciudad de México', 'Nuevo León', 'Jalisco'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-coldwellbanker-com-mx-api-9ad731ad/list_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","operation":"<string>","page":"<integer>","price_max":"<number>","price_min":"<number>","property_type_id":"<integer>","size":"<integer>","state":"<string>"}'
```