Search residential listings on Centris.ca. Pass a place such as montreal, or a full English or French results URL. The response is { results, pagination } with the asking price, the printed price label, bedrooms, bathrooms, and the street address when the card shows them.
price is the asking price in CAD. price_display is the label printed on the card, such as $568,000.
GET https://api.piloterr.com/v2/centris/search?query=montreal&language=en
GET https://api.piloterr.com/v2/centris/search?query=montreal&language=fr&page=2
GET https://api.piloterr.com/v2/centris/search?query=https://www.centris.ca/en/properties~for-sale~montreal
GET https://api.piloterr.com/v2/centris/search?query=https://www.centris.ca/fr/propriete~a-vendre~montreal&page=2
Page 1 and page 2 of Montreal return different listing ids. Send results[].url to /v2/centris/property.
| Parameter |
Type |
Required |
Placeholder |
Example |
query |
string |
yes |
montreal |
montreal |
page |
integer |
no |
2 |
2 |
language |
string |
no |
en |
fr |
query is a place name or a full results URL.
montreal with language=en calls https://www.centris.ca/en/properties~for-sale~montreal.
montreal with language=fr calls https://www.centris.ca/fr/propriete~a-vendre~montreal.
https://www.centris.ca/en/properties~for-sale~montreal keeps the English path and any filters already in the URL.
https://www.centris.ca/fr/propriete~a-vendre~montreal keeps the French path. A full URL keeps the language in its path.
page starts at 1. 2 asks Centris for the next 20 listings. When page stays at 1, a page value already present in the results URL is kept.
language is en (default) or fr. It applies when query is a place name.
| Field |
Type |
Description |
results[].id |
string |
Centris listing id |
results[].url |
string |
Listing URL to send to /v2/centris/property |
results[].address |
string or null |
Street line |
results[].city |
string or null |
City and borough |
results[].price |
number or null |
Asking price in CAD |
results[].price_display |
string or null |
Price label as printed |
results[].currency |
string or null |
CAD when a price is shown |
results[].bedrooms |
number or null |
Bedroom count on the card |
results[].bathrooms |
number or null |
Bathroom count on the card |
pagination.page |
integer |
Page Centris returned |
pagination.per_page |
integer |
Listings on this page, usually 20 |
pagination.total_results |
integer or null |
Count Centris shows |
pagination.total_pages |
integer or null |
Pages inside the Centris paging cap |
pagination.next |
string or null |
Next results URL, or null on the last page |
A card also includes title, category, photo_count, image, latitude, longitude, and language (en or fr) when Centris prints them.
- Scan Montreal or Laval inventory
- Build a listing feed for a Quebec brokerage tool
- Pick a listing id before calling Property
| Code |
Meaning |
400 |
Empty query, a domain outside centris.ca, a bad page, or a language other than en or fr. A listing URL sent to search also returns 400. |
401 |
Missing API key |
404 |
The results page had no listing cards |
500 |
The fetch failed |
Centris Property