# Centris Ad

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/centris/ad` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/centris-ad |

## Description

Fetch a single Centris Quebec property listing by URL and get full MLS details: price, area, rooms, features, photos, broker info, and open house dates as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/centris/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup Victorian house in Outremont, Montréal

```json
{
  "id": "27183641",
  "url": "https://www.centris.ca/en/houses~for-sale~montreal/27183641",
  "area": {
    "lot_area_m2": 412,
    "living_area_m2": 214,
    "building_area_m2": 228
  },
  "price": {
    "amount": 1250000,
    "currency": "CAD",
    "annual_taxes": 9840,
    "municipal_assessment": 1048000
  },
  "title": "Detached house for sale, Outremont, Montréal",
  "broker": {
    "name": "Marie-Claire Dubois",
    "phone": "+1 514-555-0182",
    "agency": "Royal LePage Altitude",
    "profile_url": "https://www.centris.ca/en/broker/marie-claire-dubois"
  },
  "photos": [
    "https://cdn.centris.ca/photos/27183641/1/1024x768.jpg",
    "https://cdn.centris.ca/photos/27183641/2/1024x768.jpg",
    "https://cdn.centris.ca/photos/27183641/3/1024x768.jpg"
  ],
  "status": "active",
  "features": {
    "pool": false,
    "floors": 3,
    "garage": true,
    "basement": "Finished",
    "bedrooms": 4,
    "bathrooms": 2,
    "year_built": 1912,
    "heating_type": "Forced air",
    "powder_rooms": 1,
    "garage_spaces": 2
  },
  "location": {
    "lat": 45.5141,
    "lng": -73.6109,
    "city": "Montréal",
    "region": "Île-de-Montréal",
    "address": "1843 Avenue McDougall, Outremont",
    "postal_code": "H2V 4H8"
  },
  "thumbnail": "https://cdn.centris.ca/photos/27183641/1/320x240.jpg",
  "updated_at": "2026-05-01T10:00:00.000Z",
  "published_at": "2026-04-29T08:00:00.000Z",
  "property_type": "house",
  "description_en": "Magnificent detached Victorian home in the heart of Outremont. 4 bedrooms, 2.5 bathrooms, double garage, and landscaped garden. Completely renovated in 2021 while preserving original architectural details.",
  "description_fr": "Magnifique maison victorienne détachée au coeur d'Outremont. 4 chambres, 2.5 salles de bain, garage double et jardin aménagé. Complètement rénovée en 2021.",
  "open_house_dates": [
    "2026-05-11T14:00:00.000Z",
    "2026-05-18T14:00:00.000Z"
  ],
  "transaction_type": "sale"
}
```

## Documentation

## Overview

Centris.ca is Quebec's official MLS platform (QPAREB). Individual listing pages carry strict bot protection. Piloterr handles the bypass and returns complete listing details as structured JSON: price, municipal assessment, taxes, area, features, broker contact, coordinates, and open house dates.

## Quickstart

```
GET https://api.piloterr.com/v2/centris/ad?url=https://www.centris.ca/en/houses~for-sale~montreal/27183641
```

## Main use cases

- Enrich a property database with construction year, taxes, and municipal assessment after collecting URLs from search results
- Monitor asking price vs. municipal assessment ratios to identify over- or under-priced listings for investment analysis
- Track open house schedules across multiple listings to coordinate visit planning for buyer's agents
- Extract broker contact data to build an outreach list of active real estate professionals in Quebec
- Feed an automated valuation model with GPS coordinates, area, and tax data for comparable-based pricing estimates