# Centris — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-centris-ca-api-4641ab64/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-centris-ca-api-4641ab64/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-centris-ca-api-4641ab64/search_houses_keywords_montreal \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-centris-ca-api-4641ab64/search_intergenerational_montreal \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-centris-ca-api-4641ab64/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-centris-ca-api-4641ab64/search_plex_montreal \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-centris-ca-api-4641ab64/search_rentals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","location":"<string>","max_price":"<integer>","min_price":"<integer>"}'
```