Skip to main content
Piloterr
Back to library

Centris Search API

Search Centris listings by city or by a full results URL. Use the English or French path. Page through properties for sale.

Active1 credit = 1 requestGET/v2/centris/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

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.

QuickstartLink to Quickstart

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.

ParametersLink to Parameters

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.

Response fieldsLink to Response fields

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.

Main use casesLink to Main use cases

  • Scan Montreal or Laval inventory
  • Build a listing feed for a Quebec brokerage tool
  • Pick a listing id before calling Property

Error codesLink to Error codes

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

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included