Recherche les inscriptions résidentielles sur Centris.ca. Passez un lieu comme montreal, ou une URL de résultats en anglais ou en français. La réponse est { results, pagination }, avec le prix demandé, le libellé affiché, les chambres, les salles de bain et la rue quand la carte les montre.
price est le prix demandé en CAD. price_display est le libellé imprimé, par exemple $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
La page 1 et la page 2 de Montréal renvoient des identifiants différents. Envoyez results[].url à /v2/centris/property.
| Paramètre |
Type |
Requis |
Placeholder |
Exemple |
query |
string |
oui |
montreal |
montreal |
page |
integer |
non |
2 |
2 |
language |
string |
non |
en |
fr |
query est un nom de lieu ou une URL de résultats complète.
montreal avec language=en appelle https://www.centris.ca/en/properties~for-sale~montreal.
montreal avec language=fr appelle https://www.centris.ca/fr/propriete~a-vendre~montreal.
https://www.centris.ca/en/properties~for-sale~montreal conserve le chemin anglais et les filtres déjà présents.
https://www.centris.ca/fr/propriete~a-vendre~montreal conserve le chemin français. Une URL complète garde la langue de son chemin.
page commence à 1. 2 demande les 20 inscriptions suivantes. Quand page reste à 1, une valeur page déjà présente dans l'URL est conservée.
language vaut en (défaut) ou fr. Il s'applique quand query est un nom de lieu.
| Champ |
Type |
Description |
results[].id |
string |
Identifiant Centris |
results[].url |
string |
URL à envoyer à /v2/centris/property |
results[].address |
string ou null |
Ligne de rue |
results[].city |
string ou null |
Ville et arrondissement |
results[].price |
number ou null |
Prix demandé en CAD |
results[].price_display |
string ou null |
Libellé du prix |
results[].currency |
string ou null |
CAD quand un prix est affiché |
results[].bedrooms |
number ou null |
Nombre de chambres |
results[].bathrooms |
number ou null |
Nombre de salles de bain |
pagination.next |
string ou null |
URL de la page suivante, ou null sur la dernière page |
La carte comprend aussi title, category, photo_count, image, latitude, longitude et language (en ou fr) quand Centris les affiche.
- Balayer l'offre à Montréal ou à Laval
- Alimenter un outil de courtage au Québec
- Choisir un id avant d'appeler Property
| Code |
Signification |
400 |
Requête vide, domaine hors centris.ca, page invalide, ou langue autre que en ou fr. Une URL d'inscription envoyée à search renvoie aussi 400. |
401 |
Clé API absente |
404 |
La page de résultats ne contient aucune carte |
500 |
Échec de la récupération |
Centris Bien