centris.ca APIcentris.ca ↗
Access Centris.ca property listings via API. Search houses, plexes, and intergenerational homes across Quebec with price, address, photos, and financial details.
curl -X GET 'https://api.parse.bot/scraper/3937f45a-c256-4bc2-bc85-6b630ec600a5/search_listings?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for residential real estate listings for sale across Quebec. Returns a paginated list of property listings with basic info including price, address, and room counts.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of listings to return. |
{
"type": "object",
"fields": {
"listings": "array of listing summaries with id, url, price, price_value, address, and description_teaser"
},
"sample": {
"data": {
"listings": [
{
"id": "23428174",
"url": "https://www.centris.ca/en/cottages~for-sale~amherst/23428174",
"price": "$1,095,000",
"address": "783, Chemin du Lac-de-la-Grange\nAmherst",
"price_value": "1095000",
"description_teaser": "23428174... Cottage for sale..."
}
]
},
"status": "success"
}
}About the centris.ca API
The Centris.ca API provides 5 endpoints to search and retrieve Quebec real estate listings, covering residential properties from single-family houses to multi-unit plexes. The get_listing_details endpoint returns a full data object including price, address, property type, description, photo URLs, and financial details like tax and assessment data — all keyed by a Centris listing ID obtained from any of the search endpoints.
Search Endpoints
Four search endpoints cover different property scopes. search_listings is the general-purpose residential search across Quebec, returning paginated listing summaries with id, url, price, price_value, address, and description_teaser. search_plex_montreal narrows to duplex, triplex, quadruplex, and quintuplex properties on the Island of Montreal and accepts min_price and max_price filters in CAD. search_intergenerational_montreal targets intergenerational homes in Montreal and accepts a max_price cap. search_houses_keywords_montreal filters single-family Montreal houses by a minimum room count (min_rooms) and keyword matches in listing descriptions, returning full detail objects rather than summaries.
Listing Detail
get_listing_details accepts a numeric listing_id string — obtainable from any search result's id field — and returns the complete listing record. The response includes photos (an array of photo URLs), property_type (e.g. "Triplex for sale"), the full description text, and a financial_details object containing tax and assessment figures not present in search summaries. The url field links directly to the canonical Centris listing page.
Coverage and Filters
All search endpoints accept an optional limit parameter to control result set size. The specialized Montreal endpoints (search_plex_montreal, search_intergenerational_montreal, search_houses_keywords_montreal) are scoped to the Island of Montreal. The general search_listings endpoint covers broader Quebec residential inventory but does not currently expose geographic or property-type filters beyond what the endpoint preset defines. Listing IDs are stable Centris numeric identifiers and can be stored for later detail lookups.
- Build a Montreal plex investment screener filtering by price range using
search_plex_montrealwithmin_priceandmax_price. - Aggregate tax and municipal assessment data from
get_listing_detailsfinancial_detailsfor comparative property analysis. - Create a keyword-driven Montreal house search using
search_houses_keywords_montrealwithmin_roomsto surface renovation or waterfront listings. - Populate a property listing feed with photo galleries by retrieving the
photosarray fromget_listing_details. - Track intergenerational home availability in Montreal using
search_intergenerational_montrealwith amax_pricethreshold. - Build a cross-listing comparison tool by resolving
idvalues from search results into full records viaget_listing_details. - Monitor Quebec residential listing volume over time using paginated calls to
search_listingswith thelimitparameter.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Centris.ca have an official developer API?+
What does `get_listing_details` return that search endpoints do not?+
get_listing_details returns the full description text, an array of photos URLs, the property_type label (e.g. "Triplex for sale"), and a financial_details object with tax and assessment figures. Search endpoints return only summary fields: id, url, price, price_value, address, and description_teaser.Are rental listings or commercial properties covered?+
Can I search listings outside of Montreal or Quebec City specifically?+
search_plex_montreal, search_intergenerational_montreal, search_houses_keywords_montreal) are scoped to the Island of Montreal. search_listings covers broader Quebec residential inventory but does not expose a free-form city or region filter parameter. You can fork the API on Parse and revise it to add region-specific endpoints for other Quebec municipalities.How current is the listing data, and can listings disappear between a search and a detail lookup?+
get_listing_details call may no longer be available, in which case the detail endpoint will return no data for that ID. Storing price_value and address from search results at query time can help preserve a snapshot.