Realtor.ca Commercial Scraper

Slug: fatihtahta/realtor-ca-commercial-scraper

Overview

Realtor.ca Commercial Scraper collects structured commercial property listing records from Realtor.ca, including listing identity, pricing, location, building and land attributes, broker and agent contacts, media, listing status, and source provenance. Realtor.ca is one of Canada's primary real estate listing portals, making its commercial listing data useful for market analysis, lead generation, competitive monitoring, and operational reporting. The actor turns public listing pages and search results into repeatable JSON records that are easier to load into analytics tools, CRMs, data warehouses, and enrichment workflows. It is designed for consistent recurring data acquisition across Canadian locations, deal types, and commercial property segments. Results reflect the public data available at run time and should be validated against your own business rules before production use.

Why Use This Actor

• Market research and analytics teams: Build structured extraction workflows for pricing, availability, geographic distribution, property types, and listing status.
• Product and content teams: Populate internal tools, content databases, and market pages with normalized commercial listing attributes.
• Developers and data engineering teams: Feed downstream systems with predictable JSON records suitable for ETL, warehouse ingestion, and API-backed applications.
• Lead generation and enrichment teams: Create targeted prospect lists from public listings, agents, brokerages, property categories, and locations.
• Monitoring and competitive intelligence teams: Schedule recurring runs to observe market movement, new listings, sold records, lease inventory, and category-level changes.

Common Use Cases

• Market intelligence: Monitor commercial supply, pricing, listing status, and location coverage across Canadian markets.
• Lead generation: Build targeted prospect datasets from public commercial listings, agents, and brokerage records.
• Competitive monitoring: Track changes in commercial inventory by property type, geography, deal type, and listing recency.
• Catalog and directory building: Populate internal databases with normalized commercial property records and contact metadata.
• Data enrichment: Add current public listing details to existing CRM, BI, or market research datasets.
• Recurring reporting: Schedule periodic runs for dashboards, alerts, trend analysis, and operational reporting.

Quick Start

1. Enter a Canadian location, such as Ottawa, Ontario, Toronto, Vancouver, or Nova Scotia.
2. Choose a deal_type: sale, lease, or sold.
3. Set a small limit, such as 25, for your first validation run.
4. Run the actor in Apify Console.
5. Inspect the first dataset records to confirm the fields match your workflow.
6. Increase limit, add filters, enable broader coverage, or schedule the actor after validating the output.

Input Parameters

This actor accepts one required location and optional commercial listing filters for deal type, property category, price, land size, building size, date, keyword, sort order, coverage, and output limit.

Parameter	Type	Description	Default
location	string	Canadian location to search. Use a city, province, neighborhood, or city with province, such as Ottawa, Ontario. Required.	Ottawa, Ontario prefill
deal_type	string	Listing category. Allowed values: sale, lease, sold.	sale
sold_within_days	string	Sold listing recency window. Used only when deal_type is sold. Allowed values: all, 7, 14, 30, 90, 180, 365.	365
property_type	string	Commercial property category. Allowed values: business, multi_family, retail, industrial, office, vacant_land, agriculture, hospitality, institutional.	-
publication_date	string	Earliest publication date for listings, formatted as a date value. Leave empty to include listings regardless of publication date.	-
keyword	string	Keyword or phrase to match against listing text. Leave empty when no text filter is needed.	-
min_price	integer	Minimum asking price in CAD. Applies to sale and sold listings; ignored for lease searches.	-
max_price	integer	Maximum asking price in CAD. Applies to sale and sold listings; ignored for lease searches.	-
exterior_building_size	string	Exterior building size range. Allowed values: 0-5000, 5001-10000, 10001-15000, 15001-20000, 20001-25000, 25001-30000, 30001-35000, 35001-40000, 40001-45000, 45001-50000, 50001-75000, 75001-100000, 100001-150000, 150001-200000, 200001-250000, 250001-0. Values represent square feet.	-
min_land_area	number	Minimum land area in acres.	-
max_land_area	number	Maximum land area in acres.	-
min_year_built	string	Earliest year built. Allowed values: 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.	-
max_year_built	string	Latest year built. Allowed values match min_year_built.	-
min_property_tax	string	Minimum annual property tax amount. Allowed values: 250, 500, 1000, 2000, 3000, 4000, 5000, 6000, 8000, 10000, 20000.	-
max_property_tax	string	Maximum annual property tax amount. Allowed values match min_property_tax.	-
min_maintenance_fee	string	Minimum monthly maintenance fee. Allowed values: 200, 300, 400, 500, 600, 700, 800, 900, 1000, 1500, 2000.	-
max_maintenance_fee	string	Maximum monthly maintenance fee. Allowed values match min_maintenance_fee.	-
sort_option	string	Listing order. Allowed values: date_desc, date_asc, price_asc, price_desc, open_houses_first, more_photos_first, virtual_tour_first.	date_desc
maximize_coverage	boolean	When enabled, collects more matching listings for broad searches while respecting filters and limit. Disable for faster exploratory runs.	true
limit	integer	Maximum number of listing records to save. Minimum value is 1.	100 prefill

Choosing Inputs

Use location as the primary scope control. Specific locations such as neighborhoods or city-province combinations produce more targeted datasets, while broader provinces or large metro areas improve discovery. Use deal_type to separate sale, lease, and sold workflows; this is especially useful when syncing results into downstream systems with different business rules.

Filters such as property_type, keyword, publication_date, price, land area, building size, year built, property tax, and maintenance fee narrow the dataset. Broader filters are better for discovery, while narrower filters are better for repeatable reporting and segmented monitoring. Start with a small limit to verify the output shape and then increase it once the first records match your use case. Use sort_option when the order of collected listings matters, such as newest listings first or price-based review.

Example Inputs

Scenario: Lease listings in Ottawa

{
  "location": "Ottawa, Ontario",
  "deal_type": "lease",
  "property_type": "multi_family",
  "limit": 50,
  "sort_option": "date_desc",
  "maximize_coverage": false
}

Scenario: Sold retail properties in Toronto

{
  "location": "Toronto, Ontario",
  "deal_type": "sold",
  "sold_within_days": "90",
  "property_type": "retail",
  "min_price": 500000,
  "max_price": 5000000,
  "limit": 100,
  "sort_option": "price_desc"
}

Scenario: Targeted office discovery in Vancouver

{
  "location": "Vancouver, British Columbia",
  "deal_type": "sale",
  "property_type": "office",
  "publication_date": "2026-05-01",
  "keyword": "medical",
  "min_land_area": 0.25,
  "limit": 75,
  "maximize_coverage": true
}

Output

9.1 Output destination

The actor writes results to an Apify dataset as JSON records. The dataset is designed for direct consumption by analytics tools, ETL pipelines, and downstream APIs with minimal post-processing.

The output shape documented below represents commercial listing records. Sale, lease, and sold records share the same general envelope, with optional fields appearing based on the data publicly available for each listing type.

9.2 Record envelope and stable identifiers

Each record represents one commercial property listing. The strongest recommended idempotency key is id; use url as a secondary key when id is unavailable, and use a composite key such as mls_number + url only when required by your downstream system. For deduplication and upserts, store the recommended key in your destination table or CRM and update the existing record when the same key appears again. Stable identifiers make records easier to merge, deduplicate, and sync across repeated runs. The source_context.source_url field provides source provenance for the run context that produced the record.

9.3 Examples

Example: sale listing (source_context.deal_type = "sale")

{
  "id": "29708926",
  "mls_number": "X13090702",
  "url": "https://www.realtor.ca/real-estate/29708926/242-victoria-street-mississippi-mills-911-almonte",
  "title": "242 VICTORIA STREET, Mississippi Mills, Ontario K0A1A0",
  "property_type": "Vacant Land",
  "description": "Build your dream home on this prime vacant lot at 242 Victoria Street in the heart of charming Almonte. Measuring approximately 63.92 x 70.19 feet, this property is ideally situated on a quiet, family-friendly residential street. Enjoy the perfect blend of small-town charm and everyday convenience, with a short walk to local amenities, schools, parks, playgrounds, and shopping. Whether you're looking to create your forever home or invest in a growing community, this is a rare opportunity to secure your own piece of land in a sought-after location. (42799628)",
  "pricing": {
    "display_price": "$159,900",
    "amount": 159900,
    "currency": "CAD",
    "short_value": "160K"
  },
  "location": {
    "address": "242 VICTORIA STREET, Mississippi Mills, Ontario K0A1A0",
    "postal_code": "K0A1A0",
    "province": "Ontario",
    "coordinates": {
      "latitude": 45.2320579,
      "longitude": -76.1911795
    },
    "permit_show_address": true
  },
  "details": {
    "property_type_id": "303",
    "building": {
      "bathroom_total": "0"
    },
    "land": {
      "size_total": "65.98 x 63.55 FT",
      "size_frontage": "65 ft ,11 in"
    }
  },
  "contacts": {
    "agents": [
      {
        "id": "2002748",
        "name": "Paul Schnittker",
        "first_name": "Paul",
        "last_name": "Schnittker",
        "position": "Salesperson",
        "photo_url": "https://cdn.realtor.ca/individuals/TS637708395000000000/highres/1285716.jpg",
        "profile_url": "https://www.realtor.ca/agent/2002748/paul-schnittker-66-mill-st-almonte-ontario-k0a1a0",
        "phones": [
          {
            "type": "Telephone",
            "number": "613-256-7285",
            "area_code": "613",
            "phone_type_id": "1"
          }
        ],
        "websites": [
          {
            "url": "http://www.ubettercallpaul.ca/",
            "website_type_id": "1"
          }
        ],
        "email_contacts": [
          {
            "contact_id": "577972188"
          }
        ],
        "organization": {
          "id": "291601",
          "name": "EXP REALTY",
          "type": "Firm",
          "designation": "Brokerage",
          "address": {
            "address": "66 MILL ST, ALMONTE, Ontario K0A1A0",
            "permit_show_address": true
          },
          "phones": [
            {
              "type": "Telephone",
              "number": "866-530-7737",
              "area_code": "866",
              "phone_type_id": "1"
            }
          ],
          "websites": [
            {
              "url": "http://exprealty.ca/",
              "website_type_id": "1"
            }
          ],
          "email_contacts": [
            {
              "contact_id": "577980330"
            }
          ],
          "profile_url": "https://www.realtor.ca/office/firm/291601/exp-realty-66-mill-st-almonte-ontario-k0a1a0",
          "has_email": true,
          "permit_free_text_email": true,
          "permit_show_listing_link": true,
          "photo_last_updated": "2026-04-24T01:50:00"
        },
        "agent_photo_last_updated": "2021-10-26T10:05:00",
        "permit_free_text_email": true,
        "permit_show_listing_link": true,
        "corporation_display_type_id": "0",
        "review_keys": {
          "real_satisfied": "Paul-Schnittker-1"
        }
      }
    ],
    "brokerages": [
      {
        "id": "291601",
        "name": "EXP REALTY",
        "type": "Firm",
        "designation": "Brokerage",
        "address": {
          "address": "66 MILL ST, ALMONTE, Ontario K0A1A0",
          "permit_show_address": true
        },
        "phones": [
          {
            "type": "Telephone",
            "number": "866-530-7737",
            "area_code": "866",
            "phone_type_id": "1"
          }
        ],
        "websites": [
          {
            "url": "http://exprealty.ca/",
            "website_type_id": "1"
          }
        ],
        "email_contacts": [
          {
            "contact_id": "577980330"
          }
        ],
        "profile_url": "https://www.realtor.ca/office/firm/291601/exp-realty-66-mill-st-almonte-ontario-k0a1a0",
        "has_email": true,
        "permit_free_text_email": true,
        "permit_show_listing_link": true,
        "photo_last_updated": "2026-04-24T01:50:00"
      }
    ]
  },
  "media": {
    "images": [
      {
        "sequence": 1,
        "high_res_url": "https://cdn.realtor.ca/listings/TS639136727810130000/reb76/highres/2/x13090702_1.jpg",
        "medium_res_url": "https://cdn.realtor.ca/listings/TS639136727810130000/reb76/medres/2/x13090702_1.jpg",
        "low_res_url": "https://cdn.realtor.ca/listings/TS639136727810130000/reb76/lowres/2/x13090702_1.jpg",
        "last_updated": "2026-05-06T13:59:41",
        "type_id": "0"
      }
    ],
    "videos": [
      {
        "category_id": "2",
        "url": "https://www.youtube.com/watch?v=KRiyToksxow",
        "description": "VideoTourWebsite",
        "order": 1,
        "video_type": "Youtube"
      }
    ]
  },
  "status": {
    "id": "1",
    "time_on_realtor": "1 day ago",
    "tags": [
      {
        "label": "1 day ago",
        "listing_tag_type_id": "1"
      }
    ]
  },
  "source_context": {
    "seed_id": "7cb78a2f9284",
    "seed_type": "query",
    "seed_value": "Ottawa, Ontario",
    "deal_type": "sale",
    "page_index": 1,
    "source_url": "https://www.realtor.ca/map?view=list&SearchText=Ottawa%2C%20Ontario"
  },
  "source_details": {
    "relative_urls": {
      "details": "/real-estate/29708926/242-victoria-street-mississippi-mills-911-almonte",
      "english": "/real-estate/29708926/242-victoria-street-mississippi-mills-911-almonte",
      "french": "/immobilier/29708926/242-victoria-street-mississippi-mills"
    },
    "historical_data_is_cleared": false,
    "timestamps": {
      "photo_changed": "2026-05-06T17:59:41",
      "inserted": "2026-05-06T16:54:50.383000+00:00",
      "data_prep_inserted": "2026-05-06T16:56:04.747000+00:00"
    },
    "uploaded_by": "76"
  }
}

Example: lease listing (source_context.deal_type = "lease")

{
  "id": "29720628",
  "mls_number": "X13100392",
  "url": "https://www.realtor.ca/real-estate/29720628/s08-61-parent-avenue-ottawa-4001-lower-townbyward-market",
  "title": "S08 - 61 PARENT AVENUE, Ottawa, Ontario K1N7A7",
  "property_type": "Multi-family",
  "description": "All-Inclusive - Fully furnished - Students/Young professionals STUDIO: AVAILABLE IMMEDIATELY!! Welcome to the newest ALL-INCLUSIVE, fully furnished building in the heart of Ottawa! The property is located 15m walk from University of Ottawa, 5 Minute walk from the Byward Market, across the street from Bruyere Hospital and MUCH MUCH MORE! This affordable yet modern property comes equipped with: Keyfob entry, A/C, WiFi included, On-site laundry, 24/7 Video security, Intercom entry, 3 Communal kitchens. Each unit comes with its very own fridge, sink and microwave-oven, desk and wall mounted TV. Enjoy downtown living at a affordable cost! (42821020)",
  "pricing": {
    "display_price": "$1,350/Monthly",
    "amount": 1350,
    "currency": "CAD",
    "short_value": "1.35K"
  },
  "location": {
    "address": "S08 - 61 PARENT AVENUE, Ottawa, Ontario K1N7A7",
    "postal_code": "K1N7A7",
    "province": "Ontario",
    "coordinates": {
      "latitude": 45.4317778,
      "longitude": -75.6957997
    },
    "permit_show_address": true
  },
  "details": {
    "property_type_id": "310",
    "building": {
      "bathroom_total": "1",
      "size_interior": "464.5113 m2",
      "type": "Other",
      "half_bath_total": "1",
      "floor_area_measurements": [
        {
          "area": "5000+ sqft",
          "area_unformatted": "5000-100000 sqft",
          "type": "Square Footage",
          "measure_unit_id": "1",
          "type_id": "1",
          "source_id": "0",
          "sort_by": "1"
        }
      ]
    },
    "land": {
      "size_total": "33.3 x 198.5 FT",
      "size_frontage": "33 ft ,3 in"
    },
    "parking": {
      "types": [
        {
          "name": "No Garage"
        }
      ],
      "display_text": "No Garage",
      "spaces_total": 0
    }
  },
  "contacts": {
    "agents": [
      {
        "id": "2247806",
        "name": "Ayantu Yeshitla",
        "first_name": "Ayantu",
        "last_name": "Yeshitla",
        "position": "Salesperson",
        "profile_url": "https://www.realtor.ca/agent/2247806/ayantu-yeshitla-2148-carling-ave-unit-6-ottawa-ontario-k2a1h1",
        "phones": [
          {
            "type": "Telephone",
            "number": "613-829-1818",
            "area_code": "613",
            "phone_type_id": "1"
          }
        ],
        "email_contacts": [
          {
            "contact_id": "578027829"
          }
        ],
        "organization": {
          "id": "61051",
          "name": "ROYAL LEPAGE INTEGRITY REALTY",
          "type": "Firm",
          "designation": "Brokerage",
          "logo_url": "https://cdn.realtor.ca/organizations/en-CA/TS639125922000000000/lowres/1125368.jpg",
          "address": {
            "address": "2148 CARLING AVE., UNIT 6, OTTAWA, Ontario K2A1H1",
            "permit_show_address": true
          },
          "phones": [
            {
              "type": "Telephone",
              "number": "613-829-1818",
              "area_code": "613",
              "phone_type_id": "1"
            }
          ],
          "websites": [
            {
              "url": "https://royallepageintegrity.ca/",
              "website_type_id": "1"
            }
          ],
          "email_contacts": [
            {
              "contact_id": "577980491"
            }
          ],
          "profile_url": "https://www.realtor.ca/office/firm/61051/royal-lepage-integrity-realty-2148-carling-ave-unit-6-ottawa-ontario-k2a1h1",
          "has_email": true,
          "permit_free_text_email": true,
          "permit_show_listing_link": true,
          "photo_last_updated": "2026-04-24T01:50:00"
        },
        "permit_free_text_email": true,
        "permit_show_listing_link": true,
        "corporation_display_type_id": "0"
      }
    ],
    "brokerages": [
      {
        "id": "61051",
        "name": "ROYAL LEPAGE INTEGRITY REALTY",
        "type": "Firm",
        "designation": "Brokerage",
        "logo_url": "https://cdn.realtor.ca/organizations/en-CA/TS639125922000000000/lowres/1125368.jpg",
        "address": {
          "address": "2148 CARLING AVE., UNIT 6, OTTAWA, Ontario K2A1H1",
          "permit_show_address": true
        },
        "phones": [
          {
            "type": "Telephone",
            "number": "613-829-1818",
            "area_code": "613",
            "phone_type_id": "1"
          }
        ],
        "websites": [
          {
            "url": "https://royallepageintegrity.ca/",
            "website_type_id": "1"
          }
        ],
        "email_contacts": [
          {
            "contact_id": "577980491"
          }
        ],
        "profile_url": "https://www.realtor.ca/office/firm/61051/royal-lepage-integrity-realty-2148-carling-ave-unit-6-ottawa-ontario-k2a1h1",
        "has_email": true,
        "permit_free_text_email": true,
        "permit_show_listing_link": true,
        "photo_last_updated": "2026-04-24T01:50:00"
      }
    ]
  },
  "media": {
    "images": [
      {
        "sequence": 1,
        "high_res_url": "https://cdn.realtor.ca/listings/TS639138008390270000/reb76/highres/2/x13100392_1.jpg",
        "medium_res_url": "https://cdn.realtor.ca/listings/TS639138008390270000/reb76/medres/2/x13100392_1.jpg",
        "low_res_url": "https://cdn.realtor.ca/listings/TS639138008390270000/reb76/lowres/2/x13100392_1.jpg",
        "last_updated": "2026-05-08T01:33:59",
        "type_id": "0"
      }
    ]
  },
  "status": {
    "id": "1",
    "time_on_realtor": "8 hours ago",
    "has_new_image_update": true,
    "tags": [
      {
        "label": "8 hours ago",
        "listing_tag_type_id": "1"
      }
    ]
  },
  "source_context": {
    "seed_id": "7cb78a2f9284",
    "seed_type": "query",
    "seed_value": "Ottawa, Ontario",
    "deal_type": "lease",
    "page_index": 1,
    "source_url": "https://www.realtor.ca/map?view=list&SearchText=Ottawa%2C%20Ontario"
  },
  "source_details": {
    "relative_urls": {
      "details": "/real-estate/29720628/s08-61-parent-avenue-ottawa-4001-lower-townbyward-market",
      "english": "/real-estate/29720628/s08-61-parent-avenue-ottawa-4001-lower-townbyward-market",
      "french": "/immobilier/29720628/s08-61-parent-avenue-ottawa"
    },
    "historical_data_is_cleared": false,
    "timestamps": {
      "photo_changed": "2026-05-08T05:33:59",
      "inserted": "2026-05-08T05:33:59.020000+00:00",
      "data_prep_inserted": "2026-05-08T05:36:24.393000+00:00"
    },
    "uploaded_by": "76"
  }
}

Example: sold listing (source_context.deal_type = "sold")

{
  "id": "28584704",
  "mls_number": "40749912",
  "url": "https://www.realtor.ca/real-estate/28584704/1226-old-carp-road-kanata",
  "title": "1226 OLD CARP Road, Kanata, Ontario K2K1X7",
  "property_type": "Multi-family",
  "pricing": {
    "display_price": "$745,000",
    "currency": "CAD",
    "short_value": "745K",
    "original_listing": {
      "amount": 798000
    }
  },
  "location": {
    "address": "1226 OLD CARP Road, Kanata, Ontario K2K1X7",
    "postal_code": "K2K1X7",
    "province": "Ontario",
    "coordinates": {
      "latitude": 45.35388116,
      "longitude": -75.94549959
    },
    "permit_show_address": true
  },
  "details": {
    "property_type_id": "310",
    "building": {
      "bathroom_total": "3",
      "bedrooms": "6",
      "size_interior": "2920.0000",
      "stories_total": "1",
      "type": "Triplex",
      "unit_total": "3",
      "floor_area_measurements": [
        {
          "area": "2920 sqft",
          "area_unformatted": "2920 sqft",
          "type": "Square Footage",
          "measure_unit_id": "1",
          "type_id": "1",
          "source_id": "0",
          "sort_by": "1"
        }
      ]
    },
    "land": {
      "size_total": "under 1/2 acre",
      "size_frontage": "100 ft"
    },
    "ownership": {
      "type": "Freehold",
      "group_ids": [
        1
      ]
    }
  },
  "media": {
    "images": [
      {
        "sequence": 1,
        "high_res_url": "https://maps.googleapis.com/maps/api/streetview?location=45.35388116%2C-75.94549959&size=600x400&source=outdoor",
        "medium_res_url": "https://maps.googleapis.com/maps/api/streetview?location=45.35388116%2C-75.94549959&size=256x200&source=outdoor",
        "low_res_url": "https://maps.googleapis.com/maps/api/streetview?location=45.35388116%2C-75.94549959&size=130x95&source=outdoor",
        "last_updated": "2026-04-23T01:03:00",
        "type_id": "1"
      }
    ]
  },
  "status": {
    "id": "2",
    "standard_status_id": "4",
    "is_sold": true,
    "tags": [
      {
        "label": "Sold on 01/07/2026",
        "listing_tag_type_id": "4"
      }
    ]
  },
  "source_context": {
    "seed_id": "7cb78a2f9284",
    "seed_type": "query",
    "seed_value": "Ottawa, Ontario",
    "deal_type": "sold",
    "page_index": 1,
    "source_url": "https://www.realtor.ca/map?view=list&SearchText=Ottawa%2C%20Ontario"
  },
  "source_details": {
    "relative_urls": {
      "details": "/real-estate/28584704/1226-old-carp-road-kanata",
      "english": "/real-estate/28584704/1226-old-carp-road-kanata",
      "french": "/immobilier/28584704/1226-old-carp-road-kanata"
    },
    "historical_data_is_cleared": true,
    "timestamps": {
      "sold_on_realtor": "2026-01-07T22:01:28",
      "sold_close": "2026-01-15T00:00:00",
      "photo_changed": "2025-12-20T17:11:00",
      "inserted": "2025-07-10T03:11:42.980000+00:00",
      "data_prep_inserted": "2025-07-10T03:16:00.847000+00:00"
    },
    "uploaded_by": "14"
  }
}

Field Reference

Commercial Listing Record

id (string, optional): Stable Realtor.ca listing identifier when available.

mls_number (string, optional): MLS number associated with the listing.

url (string, optional): Public Realtor.ca listing URL.

title (string, optional): Human-readable listing title, usually based on the public address.

property_type (string, optional): Commercial property category, such as multi-family, retail, office, industrial, business, agriculture, hospitality, institutional, or vacant land.

description (string, optional): Public listing remarks or description text.

pricing.display_price (string, optional): Price as displayed publicly.

pricing.amount (integer, optional): Numeric price amount when available.

pricing.currency (string, optional): Price currency, typically CAD.

pricing.short_value (string, optional): Compact price label when provided.

pricing.original_listing.display_price (string, optional): Original/list price text retained for sold records when available.

pricing.original_listing.amount (integer, optional): Original/list price amount retained for sold records when available.

pricing.price_change.time_on_realtor (string, optional): Public price-change timing label when available.

pricing.price_change.tag_date (string, optional): Price-change date when available.

location.address (string, optional): Public address text.

location.postal_code (string, optional): Postal code. Treat as text, not a number.

location.province (string, optional): Province name.

location.coordinates.latitude (number, optional): Latitude.

location.coordinates.longitude (number, optional): Longitude.

location.permit_show_address (boolean, optional): Whether the source indicates the address may be displayed.

details.property_type_id (string, optional): Source property type identifier. Treat as an identifier, not a number.

details.farm_type (string, optional): Farm type label when available.

details.zoning_type (string, optional): Zoning type label when available.

details.building (object, optional): Building attributes such as bathrooms, bedrooms, size, storeys, building type, unit count, and measurements.

details.building.bathroom_total (string, optional): Total bathrooms as provided by the source.

details.building.bedrooms (string, optional): Bedroom count as provided by the source.

details.building.size_interior (string, optional): Interior size value and unit when available.

details.building.stories_total (string, optional): Total storeys when available.

details.building.type (string, optional): Building type label.

details.building.unit_total (string, optional): Total unit count when available.

details.building.floor_area_measurements (array, optional): Floor area measurement records.

details.building.floor_area_measurements.area (string, optional): Display area value.

details.building.floor_area_measurements.area_unformatted (string, optional): Source area range or unformatted value.

details.building.floor_area_measurements.type (string, optional): Measurement type label.

details.building.floor_area_measurements.measure_unit_id (string, optional): Measurement unit identifier.

details.building.floor_area_measurements.type_id (string, optional): Measurement type identifier.

details.building.floor_area_measurements.source_id (string, optional): Measurement source identifier.

details.building.floor_area_measurements.sort_by (string, optional): Source ordering value.

details.land (object, optional): Land and lot attributes.

details.land.size_total (string, optional): Lot or land size display value.

details.land.size_frontage (string, optional): Frontage display value.

details.ownership.type (string, optional): Ownership type label.

details.ownership.group_ids (array, optional): Ownership group identifiers when provided.

details.parking.types (array, optional): Parking type records.

details.parking.types.name (string, optional): Parking type label.

details.parking.types.spaces (integer, optional): Parking spaces for that type when available.

details.parking.display_text (string, optional): Public parking summary.

details.parking.spaces_total (integer, optional): Total parking spaces.

details.nearby_amenities (string, optional): Public nearby amenities text when available.

details.business (object, optional): Business-specific listing attributes when available.

contacts.agents (array, optional): Public agents associated with the listing.

contacts.agents.id (string, optional): Agent identifier.

contacts.agents.name (string, optional): Agent display name.

contacts.agents.first_name / contacts.agents.last_name (string, optional): Agent name components.

contacts.agents.position (string, optional): Agent role or position.

contacts.agents.designation (string, optional): Professional designation when provided.

contacts.agents.photo_url (string, optional): Agent photo URL.

contacts.agents.profile_url (string, optional): Public agent profile URL.

contacts.agents.phones (array, optional): Public phone records.

contacts.agents.phones.type (string, optional): Phone type label.

contacts.agents.phones.number (string, optional): Formatted phone number.

contacts.agents.phones.area_code (string, optional): Phone area code.

contacts.agents.phones.phone_type_id (string, optional): Phone type identifier.

contacts.agents.websites (array, optional): Public website records.

contacts.agents.websites.url (string, optional): Website URL.

contacts.agents.websites.website_type_id (string, optional): Website type identifier.

contacts.agents.email_contacts (array, optional): Public email contact metadata.

contacts.agents.email_contacts.contact_id (string, optional): Contact identifier.

contacts.agents.organization (object, optional): Brokerage or organization associated with the agent.

contacts.agents.organization.id (string, optional): Organization identifier.

contacts.agents.organization.name (string, optional): Organization name.

contacts.agents.organization.type (string, optional): Organization type.

contacts.agents.organization.designation (string, optional): Organization designation.

contacts.agents.organization.logo_url (string, optional): Organization logo URL.

contacts.agents.organization.address.address (string, optional): Organization address.

contacts.agents.organization.address.permit_show_address (boolean, optional): Whether the organization address may be displayed.

contacts.agents.organization.phones (array, optional): Organization phone records.

contacts.agents.organization.websites (array, optional): Organization website records.

contacts.agents.organization.email_contacts (array, optional): Organization email contact metadata.

contacts.agents.organization.profile_url (string, optional): Public organization profile URL.

contacts.agents.organization.has_email (boolean, optional): Whether public email contact is available.

contacts.agents.organization.permit_free_text_email (boolean, optional): Public email contact setting.

contacts.agents.organization.permit_show_listing_link (boolean, optional): Public listing-link display setting.

contacts.agents.organization.photo_last_updated (string, optional): Organization photo update timestamp.

contacts.agents.agent_photo_last_updated (string, optional): Agent photo update timestamp.

contacts.agents.permit_free_text_email (boolean, optional): Public email contact setting.

contacts.agents.permit_show_listing_link (boolean, optional): Public listing-link display setting.

contacts.agents.corporation_name (string, optional): Agent corporation name when provided.

contacts.agents.corporation_display_type_id (string, optional): Agent display type identifier.

contacts.agents.review_keys.rank_my_agent (string, optional): Public review key when available.

contacts.agents.review_keys.real_satisfied (string, optional): Public review key when available.

contacts.agents.review_keys.testimonial_tree (string, optional): Public review key when available.

contacts.brokerages (array, optional): Deduplicated public brokerage records associated with the listing.

contacts.brokerages.id (string, optional): Brokerage identifier.

contacts.brokerages.name (string, optional): Brokerage name.

contacts.brokerages.type (string, optional): Brokerage type.

contacts.brokerages.designation (string, optional): Brokerage designation.

contacts.brokerages.logo_url (string, optional): Brokerage logo URL.

contacts.brokerages.address.address (string, optional): Brokerage address.

contacts.brokerages.address.permit_show_address (boolean, optional): Whether the brokerage address may be displayed.

contacts.brokerages.phones (array, optional): Brokerage phone records.

contacts.brokerages.websites (array, optional): Brokerage website records.

contacts.brokerages.email_contacts (array, optional): Brokerage email contact metadata.

contacts.brokerages.profile_url (string, optional): Public brokerage profile URL.

contacts.brokerages.has_email (boolean, optional): Whether public email contact is available.

contacts.brokerages.permit_free_text_email (boolean, optional): Public email contact setting.

contacts.brokerages.permit_show_listing_link (boolean, optional): Public listing-link display setting.

contacts.brokerages.photo_last_updated (string, optional): Brokerage photo update timestamp.

open_houses (array, optional): Public open house events when available.

open_houses.display_time (string, optional): Public open house display time.

open_houses.start_time / open_houses.end_time (string, optional): Open house start and end timestamps.

open_houses.event_type_id (string, optional): Open house event type identifier.

media.images (array, optional): Listing image records.

media.images.sequence (integer, optional): Image order.

media.images.high_res_url / media.images.medium_res_url / media.images.low_res_url (string, optional): Image URLs at different sizes.

media.images.svg_url (string, optional): SVG image URL when available.

media.images.description (string, optional): Image description when available.

media.images.last_updated (string, optional): Image update timestamp.

media.images.type_id (string, optional): Image type identifier.

media.videos (array, optional): Video records when available.

media.videos.category_id (string, optional): Media category identifier.

media.videos.url (string, optional): Video URL.

media.videos.description (string, optional): Video description.

media.videos.order (integer, optional): Video order.

media.videos.video_type (string, optional): Video type label.

media.floor_plans (array, optional): Floor plan records when available.

media.links (array, optional): Additional public listing links when available.

status.id (string, optional): Listing status identifier.

status.standard_status_id (string, optional): Standardized status identifier when available.

status.time_on_realtor (string, optional): Public recency label.

status.has_new_image_update (boolean, optional): Whether the listing indicates a new image update.

status.has_open_house_update (boolean, optional): Whether the listing indicates an open house update.

status.is_sold (boolean, optional): Whether the listing is sold.

status.conditionally_sold (boolean, optional): Whether the listing is conditionally sold.

status.distance (string, optional): Distance value when provided by the source context.

status.tags (array, optional): Public listing tags.

status.tags.label (string, optional): Tag label.

status.tags.listing_tag_type_id (string, optional): Tag type identifier.

source_context.seed_id (string, optional): Stable run seed identifier.

source_context.seed_type (string, optional): Seed category, such as query.

source_context.seed_value (string, optional): Location or search value that produced the record.

source_context.deal_type (string, optional): Deal type used for the record, such as sale, lease, or sold.

source_context.page_index (integer, optional): Result page index associated with the record.

source_context.source_url (string, optional): Source context URL retained for provenance.

source_details.relative_urls.details (string, optional): Relative public listing details path.

source_details.relative_urls.english (string, optional): English relative public listing path.

source_details.relative_urls.french (string, optional): French relative public listing path.

source_details.historical_data_is_cleared (boolean, optional): Public historical data flag when available.

source_details.timestamps.sold_on_realtor (string, optional): Sold timestamp reported by Realtor.ca.

source_details.timestamps.sold_close (string, optional): Sold close date when available.

source_details.timestamps.photo_changed (string, optional): Photo change timestamp.

source_details.timestamps.open_house_inserted (string, optional): Open house insertion timestamp.

source_details.timestamps.conditionally_sold_changed (string, optional): Conditional sold change timestamp.

source_details.timestamps.inserted (string, optional): Listing insertion timestamp.

source_details.timestamps.data_prep_inserted (string, optional): Data preparation timestamp.

source_details.listing_time_zone (string, optional): Listing time zone when available.

source_details.listing_boundary (string, optional): Listing boundary label when available.

source_details.listing_gmt_offset (string, optional): Listing GMT offset when available.

source_details.uploaded_by (string, optional): Public uploader label when available.

Data Quality, Guarantees, And Handling

• Structured records: results are normalized into predictable JSON objects for downstream use.
• Best-effort extraction: fields may vary by region, session, availability, and UI experiments.
• Optional fields: null-check in downstream code before using nested values.
• Deduplication: use id as the strongest stable key when available, with url, mls_number, or a composite key as fallbacks.
• Freshness: results reflect the publicly available data at run time.
• Repeated runs: use the recommended idempotency key when syncing data into warehouses, CRMs, or search indexes.

Tips For Best Results

• Start with a small limit to validate the output shape before scaling up.
• Use one geography, property type, or deal type per run when you need clean segmentation.
• Leave optional filters empty when the goal is broad market discovery.
• Add filters gradually to understand how each field changes coverage.
• Use deal_type to keep sale, lease, and sold workflows separate.
• Schedule recurring runs for monitoring workflows instead of relying on manual one-off collection.
• Use stable identifiers such as id and url for deduplication when storing results over time.

How to Run on Apify

1. Open the Actor in Apify Console.
2. Configure the available input fields for the target location, deal type, and filters.
3. Set the maximum number of outputs to collect with limit.
4. Click Start and wait for the run to finish.
5. Open the dataset and inspect the first records.
6. Download results in JSON, CSV, Excel, or other supported formats.

Scheduling & Automation

Scheduling

Automated Data Collection

Use schedules to keep commercial listing datasets fresh for monitoring, reporting, and enrichment workflows. Scheduled runs are most useful when the same location, property type, and deal type need to be collected repeatedly.

• Navigate to Schedules in Apify Console
• Create a new schedule, such as daily, weekly, or a custom cron interval
• Configure input parameters
• Enable notifications for run completion
• Add webhooks for automated processing

Integration Options

• CRM enrichment: sync public listing, brokerage, and agent attributes into account, lead, or opportunity records.
• BI dashboards: monitor pricing, availability, property type movement, and geographic coverage over time.
• Data warehouses: load normalized listing records for historical analysis and operational reporting.
• Google Sheets or Airtable: review smaller datasets, qualify leads, and coordinate manual follow-up.
• Webhooks: trigger validation, notification, or ingestion workflows after each completed run.
• Alerts and scheduled reporting: notify teams when new listings, sold records, or targeted property segments appear.

Export Formats And Downstream Use

Apify datasets can be exported or consumed by downstream systems for reporting, automation, and application workflows.

• JSON: for APIs, applications, and data pipelines
• CSV or Excel: for spreadsheet workflows and manual review
• API access: for automated ingestion into internal systems
• BI and warehouses: for reporting, dashboards, and historical analysis

Performance

Estimated run times:

• Small runs (< 1,000 outputs): ~3-5 minutes
• Medium runs (1,000-5,000 outputs): ~5-15 minutes
• Large runs (5,000+ outputs): ~15-30 minutes

Execution time varies based on filters, result volume, and how much information is returned per record. Highly filtered runs can finish faster, while broad discovery or detail-rich records may take longer.

Limitations

• Availability depends on what Realtor.ca publicly exposes at run time.
• Some optional fields may be missing on sparse records or listing types with limited public details.
• Very broad searches may take longer or require a higher limit to collect enough records.
• Target-side changes can affect field availability, labels, or naming.
• Regional, account, or availability differences may change visible results.
• Sold, lease, and sale records may expose different pricing, status, and timestamp fields.

Troubleshooting

• No results returned: Check filter combinations, location spelling, property type selection, and whether Realtor.ca has matching public records.
• Fewer results than expected: Broaden filters, raise limit, or verify that the target location contains enough matching commercial listings.
• Some fields are empty: Optional fields depend on what each listing publicly provides.
• Run takes longer than expected: Reduce scope, lower limit for validation, or split broad collection into smaller market segments.
• Output changed: Compare the current output with the field reference and include a small sample when reporting the issue.

FAQ

What data does this actor collect?

It collects public commercial property listing records from Realtor.ca, including identity fields, pricing, location, property attributes, media, status, agent and brokerage contacts, and source provenance.

Can I filter by location, category, date, price, or other criteria?

Yes. The actor supports location, deal_type, property_type, publication_date, keyword, price ranges, land area, exterior building size, year built, property tax, maintenance fee, sort order, coverage, and output limit.

Why did I receive fewer results than my limit?

The source may have fewer matching public listings than requested, filters may be narrow, or some listings may not provide enough usable information to save as records.

Can I schedule recurring runs?

Yes. Use Apify schedules to run the actor daily, weekly, or on a custom interval for monitoring and reporting workflows.

How do I avoid duplicates across runs?

Use id as the primary idempotency key. If id is unavailable, use url, then mls_number, or a composite key appropriate for your destination system.

Can I export the data to CSV, Excel, or JSON?

Yes. Apify datasets support export formats such as JSON, CSV, Excel, and other formats available in Apify Console.

Does this actor collect private data?

It is intended to collect publicly available listing information from Realtor.ca. Users are responsible for ensuring their use of the data complies with applicable laws and terms.

What should I include when reporting an issue?

Include the input used, the run ID, expected versus actual behavior, and a small output sample when possible.

Compliance & Ethics

Responsible Data Collection

This actor collects publicly available commercial real estate listing information from Realtor.ca for legitimate business purposes, including:

• Commercial real estate research and market analysis
• Lead generation and enrichment for public listing, agent, and brokerage workflows
• Operational reporting and monitoring for pricing, availability, and market coverage

This section is informational and not legal advice. Users are responsible for confirming that their collection and use of data complies with applicable laws, regulations, and contractual obligations.

Best Practices

• Use collected data in accordance with applicable laws, regulations, and the target site's terms
• Respect individual privacy and personal information
• Use data responsibly and avoid disruptive or excessive collection
• Do not use this actor for spamming, harassment, or other harmful purposes
• Follow relevant data protection requirements where applicable, such as GDPR and CCPA

Support

For help, use the Issues tab or the actor page in Apify Console. Include the input used, with sensitive values redacted if needed; the run ID; expected versus actual behavior; and a small output sample when relevant. Avoid sharing private credentials, proprietary datasets, or unnecessary personal information in support requests.