Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Centris Search

Recherchez des annonces Centris par ville ou par URL de résultats. Utilisez le chemin anglais ou français. Parcourez les biens à vendre.

Actif1 crédit = 1 requêteGET/v2/centris/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

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.

DémarrageLink to Démarrage

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ètresLink to Paramètres

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.

Champs de la réponseLink to Champs de la réponse

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.

Cas d'utilisationLink to Cas d'utilisation

  • Balayer l'offre à Montréal ou à Laval
  • Alimenter un outil de courtage au Québec
  • Choisir un id avant d'appeler Property

Codes d'erreurLink to Codes d'erreur

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

Endpoints liésLink to Endpoints liés

Centris Bien

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus