{ "openapi": "3.0.1", "info": { "title": "Centris Scraper", "description": "Scrape Quebec real estate from Centris.ca: houses, condos, plexes, lots, commercial and rentals. Price, address, beds, baths, GPS, photos, Centris number. Full details add description, year built, area, taxes, assessment, brokers with phones and all photos. Search by URL or city.", "version": "0.0", "x-build-id": "1kcXsDh5SShR7LGq3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~centris-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~centris-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~centris-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Centris.ca search URLs (e.g. https://www.centris.ca/en/properties~for-sale~montreal) or listing URLs (e.g. https://www.centris.ca/en/condos~for-sale~montreal-ville-marie/20267781). English and French URLs both work. When this list has URLs, the city search below is not used.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "A Centris.ca search or listing URL" } }, "required": [ "url" ] } }, "city": { "title": "City", "type": "string", "description": "Quebec city or borough to search when Start URLs is empty, e.g. montreal, laval, quebec (Quebec City), gatineau, sherbrooke, trois-rivieres, longueuil, levis, montreal-ville-marie. Accents and spaces are fine." }, "transaction": { "title": "Transaction", "enum": [ "for-sale", "for-rent" ], "type": "string", "description": "For sale or for rent. Used with City; ignored when Start URLs has URLs.", "default": "for-sale" }, "propertyType": { "title": "Property type", "enum": [ "properties", "houses", "condos", "plexes", "duplexes", "triplexes", "lofts-studios", "intergenerational-homes", "cottages", "mobile-homes", "lots", "farms", "commercial-properties", "offices", "businesses" ], "type": "string", "description": "Property type to search. Used with City; ignored when Start URLs has URLs. Plexes, duplexes and triplexes exist only for sale on Centris.", "default": "properties" }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of listings to return across all searches. Default 100.", "default": 100 }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Stop each search after this many result pages (20 listings per page). 0 = no page limit, only Max results applies. Centris shows at most 5,000 listings (250 pages) for one search; split large cities by property type or borough to go further.", "default": 0 }, "fetchFullDetails": { "title": "Fetch full details", "type": "boolean", "description": "Open each listing's page for the full description, rooms, year built, living and lot area, all characteristics, municipal assessment, yearly taxes and fees, Walk Score, every listing broker with phone numbers and agency, and all photos with captions. Adds two requests per listing.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many Centris requests run at once (1-50).", "default": 10 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Centris answers Apify's datacenter proxies, which is the default. Switch to RESIDENTIAL only if runs start failing with HTTP 403." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }