Centris Real Estate Scraper

Scrape Centris.ca — the official real estate listing network used by every real estate board in the province of Quebec, Canada. Browse houses, condos, plexes, cottages, lots and lofts for sale or for rent across 69 regions and cities, or fetch full details for specific listing URLs.

What this actor does

• Two modes: search (browse by region, property type, transaction type) and byUrls (fetch specific listing pages you already have links for)
• 7 property types: house, condo/apartment, plex (duplex/triplex/income property), cottage, lot/land, loft/studio, or all
• Buy or rent: every property type is available for sale; most are also available for rent
• 69 regions/cities: every Quebec administrative region plus major cities, or search all of Quebec / all of Canada at once
• Client-side filters: price range, minimum bedrooms, minimum bathrooms, listing badge (new price / new property / open house)
• Full detail enrichment (optional): net area, year built, parking, move-in date, extra characteristics, full description, listing broker and agency
• Empty fields are omitted — every record only contains fields Centris actually published for that listing

Output per listing

• mlsNumber — the Centris listing number
• title, propertyType, transactionType (sale / rent)
• price, currency
• addressStreet, addressCity, fullAddress
• bedrooms, bathrooms
• netArea, lotArea, buildingArea, yearBuilt, parkingTotal, additionalFeatures, moveInDate
• characteristics — any other listing attributes Centris publishes (condo type, fireplace, heating, etc.)
• description — full listing remarks
• brokerName, brokerTitle, agencyName
• imageUrl, imageUrls[], imageCount
• latitude, longitude
• listingBadges — Centris.ca merchandising badges currently on the listing (e.g. New price, New property, Open house)
• openHouseSchedule — upcoming open-house date/time slots, when the listing has any scheduled (includeDetails/byUrls only)
• sourceUrl — the canonical Centris.ca listing page
• recordType: "listing", scrapedAt

Input

Field	Type	Default	Description
mode	select	search	search / byUrls
transactionType	select	for-sale	for-sale / for-rent (mode=search)
propertyType	select	all	all / house / condo / plex / cottage / lot / loft-studio (mode=search)
location	select	all-quebec	Quebec region or city, all-quebec, or canada (mode=search)
minPrice	int	–	Drop listings priced below this (CAD)
maxPrice	int	–	Drop listings priced above this (CAD)
minBedrooms	int	–	Drop listings with fewer bedrooms
minBathrooms	int	–	Drop listings with fewer bathrooms
listingBadge	select	–	Only keep listings carrying this badge: newPrice / newProperty / openHouse
sortBy	select	relevance	Server-side order to fetch listings in: relevance / priceAsc / priceDesc / newest / oldest (mode=search)
includeDetails	bool	true	Fetch each listing's detail page for full fields (slower, more complete)
startUrls	array	–	Centris.ca listing URLs to fetch (mode=byUrls)
maxItems	int	20	Hard cap on emitted records (1–500)

Example: houses for sale in Montreal, $400K–$700K, 3+ bedrooms

{
  "mode": "search",
  "transactionType": "for-sale",
  "propertyType": "house",
  "location": "montreal-island",
  "minPrice": 400000,
  "maxPrice": 700000,
  "minBedrooms": 3,
  "maxItems": 50
}

Example: condo rentals in Laval

{
  "mode": "search",
  "transactionType": "for-rent",
  "propertyType": "condo",
  "location": "laval",
  "maxItems": 30
}

Example: fetch specific listing URLs

{
  "mode": "byUrls",
  "startUrls": [
    "https://www.centris.ca/en/condos~for-sale~montreal-saint-laurent/17985337"
  ]
}

Use cases

• Real estate market research — track prices, inventory, and days-on-market across Quebec regions
• Investment analysis — screen plexes and income properties for cap-rate modeling
• Relocation / rental search — pull all rentals in a target city into a spreadsheet or CRM
• Lead generation for agents/brokers — monitor new listings in a farm area
• Data aggregation — feed a real estate portal or price-tracking tool

FAQ

What's Centris? The official MLS-backed listing network operated by Quebec's real estate boards (AQPI / QPAREB). Every licensed Quebec broker publishes listings there, making it the most complete source for Quebec real estate.

Does this cover all of Canada? Centris itself is Quebec-focused, though it also carries some listings tagged "Canada" (mostly other-province listings cross-posted by Quebec brokers). Set location to canada to include those -- but note Centris only exposes this cross-Canada view for propertyType: "all" combined with transactionType: "for-sale"; any other property type or for-rent combined with location: "canada" isn't routable on Centris.ca, and the actor fails soft with a clear status message instead of returning 0 unexplained records.

Why do some listings have fewer fields than others? Fields depend on what the listing agent published — e.g. a vacant lot has no bedrooms; a rental usually omits yearBuilt. The actor only includes fields Centris actually populated.

Why is includeDetails optional? Search-results pages already carry price, address, bedrooms, bathrooms and a thumbnail. Turning on includeDetails fetches each listing's own page for net area, year built, description, broker/agency and the full photo gallery — more complete but roughly 2x slower.

How many listings can I pull at once? Up to 500 per run. Centris paginates 20 listings per page.

Can I search by keyword/address? Not directly — Centris's keyword search requires a stateful multi-step session. Use location (region/city) combined with propertyType/transactionType/price/bedroom filters, or supply specific listing URLs via byUrls if you already know which properties you want.

Are prices in CAD? Yes, all Centris listings are priced in Canadian dollars.

What are listingBadges? Merchandising flags Centris itself displays on a listing: New price (recent price reduction), New property (newly listed), and Open house (a scheduled showing). Use listingBadge to filter to just one of these -- badges are read straight off the search-results page, so this filter works with or without includeDetails.

When is openHouseSchedule populated? Only when the listing has an Open house badge AND you fetch its detail page — i.e. with includeDetails: true (the default in search mode) or always in byUrls mode. It lists each upcoming showing's date and time window.