# Coldwellbanker — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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>"}'
```