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

> Search and retrieve real estate listings from Centris.ca, Canada's largest real estate platform. Filter by location, property type, price range, and keywords to find houses, condos, plexes, and multi-generational properties across Quebec. Get detailed listing information including price, address, room counts, and photos.

**Category:** Real Estate | **Website:** [centris.ca/](https://centris.ca/) | **Docs:** [parse.bot/marketplace/4641ab64-138b-4241-a849-6bc15ab28438/centris-ca-api](https://parse.bot/marketplace/4641ab64-138b-4241-a849-6bc15ab28438/centris-ca-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/centris/`
**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 details

Retrieve full details of a specific property listing by its Centris ID. Returns price, address, property type, room counts, full description text, financial details (tax assessments), and photo URLs. The listing_id is obtainable from any search endpoint's results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | The Centris listing ID (numeric string, e.g. 20102820). Obtainable from search_listings results. |

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

### Search houses keywords montreal

Search for single-family houses in Montreal with a minimum room count whose descriptions match specific keywords (bachelor, intergenerational). Fetches listing details for each candidate and filters by room count and keyword match. Returns full listing detail objects for matching properties.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of matching listings to return. |
| `min_rooms` | integer | No | Minimum number of rooms required. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/centris/search-houses-keywords-montreal \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","min_rooms":"<integer>"}'
```

### Search intergenerational montreal

Search for intergenerational homes for sale on the Island of Montreal up to a maximum price. Returns listing summaries. Use get_listing_details with an id from the results to fetch full property information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of listings to return. |
| `max_price` | integer | No | Maximum price in CAD. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/centris/search-intergenerational-montreal \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","max_price":"<integer>"}'
```

### Search listings

Search for residential real estate listings for sale across Quebec. Returns a paginated list of property listing summaries. Each summary includes id, URL, price, address, and a description teaser. Use get_listing_details with an id from the results to fetch full property information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of listings to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/centris/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Search plex montreal

Search for plex properties (duplex, triplex, quadruplex, quintuplex) for sale on the Island of Montreal within an optional price range. Returns listing summaries with id, price, and address. Use get_listing_details with an id from the results to fetch full property information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of listings to return. |
| `max_price` | integer | No | Maximum price in CAD. |
| `min_price` | integer | No | Minimum price in CAD. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/centris/search-plex-montreal \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","max_price":"<integer>","min_price":"<integer>"}'
```

### Search rentals

Search for residential rental listings across Quebec. Returns a paginated list of rental property summaries including id, URL, price (monthly rent), address, property type, and description teaser. Optionally filter by location and price range. Use get_listing_details with an id from the results to fetch full property information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of listings to return. |
| `location` | string | No | Location filter text (e.g. "Montreal", "Quebec City"). Matches city or region names on Centris. |
| `max_price` | integer | No | Maximum monthly rent in CAD. |
| `min_price` | integer | No | Minimum monthly rent in CAD. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/centris/search-rentals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","location":"<string>","max_price":"<integer>","min_price":"<integer>"}'
```

## Next steps

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