Compass Scraper

Compass Scraper extracts public Compass.com real estate listings into one stable dataset row per property. It supports location-built searches, existing Compass search URLs, individual listing URLs, for-sale, rental, and sold pages, and optional detail-page enrichment.

Each stored listing costs $0.005, plus a small actor-start event and normal Apify usage. The maximum record-event cost is maxResults × $0.005; the actor prints that cap before crawling and charges only after a schema-valid dataset write.

Input

Minimal location search:

{
  "locations": ["Boston, MA"],
  "listingType": "for-sale",
  "maxResults": 1,
  "maxPages": 1,
  "includeDetails": false
}

For saved filters, neighborhoods, or a direct listing, provide a public Compass URL:

{
  "startUrls": [
    { "url": "https://www.compass.com/homes-for-sale/manhattan-ny/" }
  ],
  "maxResults": 50
}

locations defaults to Boston with one result, one page, and detail enrichment disabled so the default health check finishes quickly. Increase the limits and enable details for production runs. startUrls are combined with location URLs, so set locations to an empty list when you only want custom URLs. The actor accepts only https://www.compass.com/ URLs.

Output

Each dataset item includes listing identity and provenance plus fields such as price, price text, beds, baths, living area, lot size, property type, address, coordinates, description, images, agent, brokerage, MLS ID, and scrape time. Compass does not publish every field for every property; missing public fields are null and extraction warnings stay in the warnings array.

The actor supports both Compass's current cx-react-listingCard markup and its earlier listing-card attributes. Detail pages and JSON-LD/meta tags provide enrichment fallbacks.

Access and limitations

Compass may show JavaScript verification, rate-limit, or regional access challenges. The actor detects those pages, does not fabricate records, and reports a blocked run when no usable search page completes. An Apify residential proxy is requested by default; pass an authorized proxyConfiguration to change that behavior.

This actor reads public web pages only. You are responsible for complying with Compass terms, applicable law, privacy rules, MLS/data-feed restrictions, and responsible use of any public contact information. It is not affiliated with Compass.

API example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('YOUR_USERNAME/compass-scraper').call({
  "locations": ["Boston"],
  "maxResults": 10,
  "includeDetails": true
});
console.log(run.defaultDatasetId);