{
  "openapi": "3.0.1",
  "info": {
    "title": "Centris.ca Scraper",
    "description": "Scrape Centris.ca, Quebec's leading real-estate marketplace. Enriched property details by listing number or URL, search For-Sale / For-Rent by location, coordinates, polygon or URL, real-estate broker (agent) search + profiles, and location autocomplete. Residential & commercial, prices in CAD.",
    "version": "1.0",
    "x-build-id": "WAP0yPVoWEg594qLC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/one-api~centris-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-one-api-centris-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/one-api~centris-scraper/runs": {
      "post": {
        "operationId": "runs-sync-one-api-centris-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/one-api~centris-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-one-api-centris-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "property_inputs": {
            "title": "Listing number or Centris.ca URL (one per line)",
            "type": "array",
            "description": "Auto-detects each entry and calls the right endpoint:\n• A numeric Centris listing number / MLS № (e.g. `18658627`) → `/details/byid`\n• A `https://www.centris.ca/...` listing URL → `/details/byurl`\n\nEach row = one fully-enriched property record (price, address, latitude/longitude, every photo, full characteristics, units, financials & taxes, description, and the listing broker(s)). The complete upstream JSON is always kept in the `Raw` column.",
            "items": {
              "type": "string"
            }
          },
          "search_inputs": {
            "title": "Location name or Centris.ca search URL (one per line)",
            "type": "array",
            "description": "Auto-detects each entry and routes to the right `/search/*` endpoint:\n• A Centris.ca results URL (e.g. `https://www.centris.ca/en/properties~for-sale~montreal`) → `/search/byurl` (replays that exact search, including any encoded filters)\n• Anything else (a city / borough / region name, e.g. `Montreal`, `Quebec City`, `Laval`) → `/search/bylocation`\n\nThe Search Filters & Pagination below apply to every location search. Each hit returns one row per property listing.",
            "items": {
              "type": "string"
            }
          },
          "coordinate_inputs": {
            "title": "Coordinates: lat,lng or lat,lng,radiusKm (one per line)",
            "type": "array",
            "description": "Radius search around a point via `/search/bycoordinates`. One point per line as `latitude,longitude` or `latitude,longitude,radiusKm` (radius in kilometres, default 3). Example: `45.5017,-73.5673,2` searches 2 km around downtown Montreal. The Search Filters below also apply. One row per listing.",
            "items": {
              "type": "string"
            }
          },
          "polygon_inputs": {
            "title": "Polygon: space-separated lat,lng points (one polygon per line)",
            "type": "array",
            "description": "Search inside an arbitrary map polygon via `/search/bypolygon`. One polygon per line, as space-separated `lat,lng` points (at least 3). Example: `45.52,-73.60 45.50,-73.55 45.48,-73.62`. The Search Filters below also apply. One row per listing.",
            "items": {
              "type": "string"
            }
          },
          "agent_search_inputs": {
            "title": "Broker name, or agency:<office> / area:<city> (one per line)",
            "type": "array",
            "description": "Search real-estate brokers via `/agent/search`. Per line:\n• A broker name (e.g. `Marie Tremblay`) → brokers whose name matches\n• `agency:<office name>` (e.g. `agency:RE/MAX`) → brokers at that agency / office\n• `area:<city or region>` (e.g. `area:Montreal`) → brokers active in that area\n\nUse the optional Broker language filter below to narrow by spoken language. Each row = one broker (name, title, agency, phone, photo, profile URL). Use a broker id in the section below for the full profile.",
            "items": {
              "type": "string"
            }
          },
          "agent_id_inputs": {
            "title": "Broker id / code (one per line)",
            "type": "array",
            "description": "For each Centris broker code (e.g. `h6088`) the actor fetches `/agent/details` — the full broker profile (name, title, agency, phones, email, languages, address, listing count, profile URL). Get broker ids from the Agent search above.",
            "items": {
              "type": "string"
            }
          },
          "autocomplete_inputs": {
            "title": "Location text to resolve (one per line)",
            "type": "array",
            "description": "Resolve a free-text place (city / borough / region) to the Centris geographic records used by Search, via `/autocomplete`. Minimum 3 characters. Each suggestion = one row (id, label, type, level). Feed an id back into a location search if you want an exact geographic scope.",
            "items": {
              "type": "string"
            }
          },
          "searchType": {
            "title": "Listing type",
            "enum": [
              "For_Sale",
              "For_Rent"
            ],
            "type": "string",
            "description": "For Sale or For Rent. Applies to every location / coordinate / polygon search. (Centris has no Sold data — listing status is Sale or Rent only.)",
            "default": "For_Sale"
          },
          "category": {
            "title": "Category",
            "enum": [
              "Residential",
              "Commercial"
            ],
            "type": "string",
            "description": "Residential or Commercial property. Applies to every search.",
            "default": "Residential"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "",
              "house",
              "condo",
              "plex",
              "loft",
              "intergenerational",
              "mobile_home",
              "cottage",
              "farm",
              "land",
              "multi_family",
              "office",
              "industrial",
              "commercial",
              "business"
            ],
            "type": "string",
            "description": "Limit results to a property type. Leave as Any for all types. Commercial types (Office, Industrial, Commercial building, Business) require Category = Commercial above. You can also pass several comma-separated types directly in this field.",
            "default": ""
          },
          "plexType": {
            "title": "Plex type",
            "enum": [
              "",
              "duplex",
              "triplex",
              "quadruplex",
              "quintuplex"
            ],
            "type": "string",
            "description": "Only used when Property type is Plex — pick the plex size. Leave as Any for all plexes.",
            "default": ""
          },
          "priceRange": {
            "title": "Price range (CAD)",
            "type": "string",
            "description": "Format: `min:200000,max:600000` — or just `min:200000` / `max:600000`. For rent, this is the monthly rent.",
            "default": ""
          },
          "bedrooms": {
            "title": "Bedrooms",
            "type": "string",
            "description": "Minimum bedrooms. Use an exact count (e.g. `3`) or `3+` for 3 or more.",
            "default": ""
          },
          "bathrooms": {
            "title": "Bathrooms",
            "type": "string",
            "description": "Minimum bath / powder rooms (e.g. `2` → 2 or more).",
            "default": ""
          },
          "parking": {
            "title": "Parking spaces",
            "type": "string",
            "description": "Minimum parking spaces (e.g. `1` → 1 or more).",
            "default": ""
          },
          "garage": {
            "title": "Garages",
            "type": "string",
            "description": "Minimum garages (e.g. `1` → 1 or more).",
            "default": ""
          },
          "livingArea": {
            "title": "Living area",
            "type": "string",
            "description": "Living-area range in the unit chosen below, e.g. `min:800,max:2000` (or just one half).",
            "default": ""
          },
          "landArea": {
            "title": "Land area",
            "type": "string",
            "description": "Lot / land-area range in the unit chosen below, e.g. `min:3000,max:10000` (or just one half).",
            "default": ""
          },
          "areaUnit": {
            "title": "Area unit",
            "enum": [
              "sqft",
              "sqm",
              "acre"
            ],
            "type": "string",
            "description": "Unit for the living-area and land-area ranges above.",
            "default": "sqft"
          },
          "pool": {
            "title": "Has a pool",
            "type": "boolean",
            "description": "Only listings with a pool.",
            "default": false
          },
          "waterfront": {
            "title": "Waterfront / near water",
            "type": "boolean",
            "description": "Only waterfront / near-water listings.",
            "default": false
          },
          "elevator": {
            "title": "Has an elevator",
            "type": "boolean",
            "description": "Only listings with an elevator.",
            "default": false
          },
          "furnished": {
            "title": "Furnished",
            "type": "boolean",
            "description": "Only furnished listings (most relevant for rentals).",
            "default": false
          },
          "petsAllowed": {
            "title": "Pets allowed",
            "type": "boolean",
            "description": "Only listings where pets are allowed (most relevant for rentals).",
            "default": false
          },
          "openHouse": {
            "title": "Open house",
            "type": "boolean",
            "description": "Only listings with an upcoming open house.",
            "default": false
          },
          "language": {
            "title": "Broker language (Agent search only)",
            "enum": [
              "",
              "english",
              "french",
              "spanish"
            ],
            "type": "string",
            "description": "Filter the Agents search above by a language the broker speaks. Leave as Any for no filter. Ignored by property searches.",
            "default": ""
          },
          "pages": {
            "title": "Pages per search",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many result pages to fetch for each location / coordinate / polygon / agent search (stops early when there are no more results).",
            "default": 1
          },
          "resultCount": {
            "title": "Results per page",
            "minimum": 1,
            "maximum": 60,
            "type": "integer",
            "description": "Listings (or brokers) per page for every search (1–60).",
            "default": 20
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}