{ "openapi": "3.0.1", "info": { "title": "Realtor.CA Scraper with Agents | $1 / 1k", "description": "Extract structured Canada real estate listings from Realtor.ca with property signals, seller details, media assets, contact data and more. Built for enterprise-grade Canada property intelligence, listing monitoring, lead enrichment and automated analytics pipelines.", "version": "0.1", "x-build-id": "DHC0TdQmO1QH9WZ2r" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~realtor-canada-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-realtor-canada-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/fatihtahta~realtor-canada-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-realtor-canada-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/fatihtahta~realtor-canada-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-realtor-canada-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", "required": [ "location" ], "properties": { "location": { "title": "Search Location", "minLength": 1, "type": "string", "description": "Enter one Canadian location to search. Examples: \"Ottawa\", \"Ottawa, Ontario\", \"Toronto\", \"Vancouver\", \"Nova Scotia\", or \"Ontario\". Broader areas can return more listings, while specific places produce more targeted results." }, "deal_type": { "title": "Choose Listing Category", "enum": [ "buy", "rent", "sold" ], "type": "string", "description": "Choose whether to collect properties for sale, properties for rent, or sold properties. The default category is properties for sale.", "default": "buy" }, "sold_within_days": { "title": "Sold Within", "enum": [ "all", "7", "14", "30", "90", "180", "365" ], "type": "string", "description": "Limits sold listings to properties sold within the selected timeframe on Realtor.ca. The default is 365 days. Choose All to include sold listings from any date. This filter is automatically ignored for For Sale and For Rent searches.", "default": "365" }, "property_type": { "title": "Select Property Type", "enum": [ "residential", "condo_strata", "vacant_land", "recreational", "multi_family", "agriculture", "parking" ], "type": "string", "description": "Restrict results to a Realtor.ca property category such as residential, condo/strata, vacant land, or multi-family. Leave empty to include all available property types." }, "building_type": { "title": "Select Building Type", "enum": [ "house", "row_townhouse", "apartment", "duplex", "triplex", "fourplex", "garden_home", "mobile_home", "manufactured_home_mobile", "special_purpose", "residential_commercial_mix", "manufactured_home", "commercial_apartment", "two_apartment_house", "park_model_mobile_home", "floathome" ], "type": "string", "description": "Limit results to a specific building format, such as house, apartment, duplex, or row/townhouse. Leave empty when any building type is acceptable." }, "publication_date": { "title": "Set Earliest Publication Date", "type": "string", "description": "Only include listings published on or after the selected date. Leave empty to include listings regardless of publication date." }, "keyword": { "title": "Filter by Keyword", "type": "string", "description": "Enter keyword text to focus results on listings that match a specific term or phrase. Leave empty when no keyword filter is needed." }, "open_house_only": { "title": "Include Open Houses Only", "type": "boolean", "description": "Collect only listinby gs that show open house availability in the next 7 days. Keep this off when you do not want to exclude other listings.", "default": false }, "live_stream_only": { "title": "Include Live Stream Open Houses Only", "type": "boolean", "description": "Collect only listings that show live stream open house availability in the next 7 days. Keep this off for a broader result set.", "default": false }, "bedroom_count": { "title": "Choose Bedroom Requirement", "enum": [ "1+", "2+", "3+", "4+", "5+", "1", "2", "3", "4", "5" ], "type": "string", "description": "Select either a minimum bedroom count, such as 3+, or an exact bedroom count, such as 3. Leave empty when bedroom count should not narrow the search." }, "bathroom_count": { "title": "Choose Bathroom Requirement", "enum": [ "1+", "2+", "3+", "4+", "5+", "1", "2", "3", "4", "5" ], "type": "string", "description": "Select either a minimum bathroom count, such as 2+, or an exact bathroom count, such as 2. Leave empty when bathroom count should not narrow the search." }, "min_price": { "title": "Set Minimum Price", "minimum": 0, "type": "integer", "description": "Only include listings with an asking price at or above this amount. Leave empty when there is no minimum price." }, "max_price": { "title": "Set Maximum Price", "minimum": 0, "type": "integer", "description": "Only include listings with an asking price at or below this amount. Leave empty when there is no maximum price." }, "min_building_area": { "title": "Set Minimum Building Area (sqft)", "minimum": 0, "type": "integer", "description": "Only include listings with a building area at or above this many square feet. Leave empty when there is no minimum building size." }, "max_building_area": { "title": "Set Maximum Building Area (sqft)", "minimum": 0, "type": "integer", "description": "Only include listings with a building area at or below this many square feet. Leave empty when there is no maximum building size." }, "min_land_area": { "title": "Set Minimum Land Area (acre)", "minimum": 0, "type": "number", "description": "Only include listings with a land area at or above this many acres. Leave empty when there is no minimum land size." }, "max_land_area": { "title": "Set Maximum Land Area (acre)", "minimum": 0, "type": "number", "description": "Only include listings with a land area at or below this many acres. Leave empty when there is no maximum land size." }, "min_storey": { "title": "Set Minimum Storeys", "enum": [ "1", "2", "3", "4", "5", "6", "10", "15", "20", "50" ], "type": "string", "description": "Only include listings with at least this many storeys. Leave empty when there is no minimum storey requirement." }, "max_storey": { "title": "Set Maximum Storeys", "enum": [ "1", "2", "3", "4", "5", "6", "10", "15", "20", "50" ], "type": "string", "description": "Only include listings with at most this many storeys. Leave empty when there is no maximum storey requirement." }, "min_year_built": { "title": "Set Earliest Year Built", "enum": [ "2026", "2025", "2024", "2023", "2022", "2021", "2020", "2019", "2018", "2017", "2016", "2015", "2010", "2005", "2000", "1990", "1980", "1970", "1960", "1950", "1940", "1930", "1920", "1910", "1900" ], "type": "string", "description": "Only include listings built in or after this year. Leave empty when there is no earliest year requirement." }, "max_year_built": { "title": "Set Latest Year Built", "enum": [ "2026", "2025", "2024", "2023", "2022", "2021", "2020", "2019", "2018", "2017", "2016", "2015", "2010", "2005", "2000", "1990", "1980", "1970", "1960", "1950", "1940", "1930", "1920", "1910", "1900" ], "type": "string", "description": "Only include listings built in or before this year. Leave empty when there is no latest year requirement." }, "min_property_tax": { "title": "Set Minimum Annual Property Tax", "enum": [ "250", "500", "1000", "2000", "3000", "4000", "5000", "6000", "8000", "10000", "20000" ], "type": "string", "description": "Only include listings with annual property tax at or above this amount. Leave empty when there is no minimum annual tax." }, "max_property_tax": { "title": "Set Maximum Annual Property Tax", "enum": [ "250", "500", "1000", "2000", "3000", "4000", "5000", "6000", "8000", "10000", "20000" ], "type": "string", "description": "Only include listings with annual property tax at or below this amount. Leave empty when there is no maximum annual tax." }, "min_maintenance_fee": { "title": "Set Minimum Monthly Maintenance Fee", "enum": [ "200", "300", "400", "500", "600", "700", "800", "900", "1000", "1500", "2000" ], "type": "string", "description": "Only include listings with monthly maintenance fees at or above this amount. Leave empty when there is no minimum monthly fee." }, "max_maintenance_fee": { "title": "Set Maximum Monthly Maintenance Fee", "enum": [ "200", "300", "400", "500", "600", "700", "800", "900", "1000", "1500", "2000" ], "type": "string", "description": "Only include listings with monthly maintenance fees at or below this amount. Leave empty when there is no maximum monthly fee." }, "sort_option": { "title": "Sort Listings", "enum": [ "date_desc", "date_asc", "price_asc", "price_desc", "open_houses_first", "more_photos_first", "virtual_tour_first" ], "type": "string", "description": "Select the listing order used for the Realtor.ca search results. The default is newest listings first.", "default": "date_desc" }, "maximize_coverage": { "title": "Collect all matching listings while respecting maximum limits and filters", "type": "boolean", "description": "Keep this enabled for large searches that may exceed the visible-result limit. Turn it off for faster exploratory runs where the first visible set of matching listings is enough.", "default": true }, "limit": { "title": "Set Maximum Results", "minimum": 1, "type": "integer", "description": "Enter the maximum number of listings to save across the whole run. Leave empty to collect as many matching listings as the run can retrieve." } } }, "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 } } } } } } } } } }