Below is your fully optimized, SEO-friendly, professional README for the Compass Urls Spider · Apify Actor, crafted in a polished documentation style and aligned with your sample’s format and tone.

---

🧭 Compass Urls Spider · Apify Actor

---

📌 What Is Compass Urls Spider?

Compass Urls Spider is a powerful Apify Actor designed to scrape detailed property information from any Compass listing URL. Whether you are analyzing property trends, monitoring listings, generating real-estate datasets, or powering an internal system — this actor automates everything.

Simply provide one or multiple Compass URLs, and the actor returns clean, structured JSON data including property details, pricing, features, schools, agent info, images, and more.

---

🧠 Key Features

• 🏡 Comprehensive Property Data (beds, baths, square footage, lot size, agent info, description, price history & more)
• 🌐 Supports Multiple URLs in a single run
• 🛡️ Built-in Apify Residential Proxy compatibility
• ⚡ Fast, reliable, and optimized to bypass blocking
• 📷 Extracts listing images + related metadata
• 🧩 Perfect for integrations (ETL pipelines, dashboards, analytics tools)
• 🧭 Works even on canceled or off-market listings

---

🛠️ Input Schema

Here’s how you provide input to the actor:

{
  "Urls": [
    "https://www.compass.com/listing/113-jefferson-drive-columbia-tn-38401/1721827764917827545/"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}

🔐 Proxy Configuration Notes

• useApifyProxy — Must be true for stable scraping
• apifyProxyGroups — "RESIDENTIAL" recommended for lowest block rates

---

📤 Output Example

Below is a real example of the output provided by the actor:

[
  {
    "title": "113 Jefferson Drive, Columbia, TN, 38401",
    "property_type": null,
    "price": null,
    "bedrooms": 4,
    "bathrooms": 5,
    "square_footage": null,
    "lot_size": null,
    "year_built": null,
    "street_address": "113 Jefferson Drive",
    "city": "Columbia",
    "state": "TN",
    "zip_code": "38401",
    "neighborhood": "Columbia",
    "parking_spaces": null,
    "heating": null,
    "cooling": null,
    "HOA_fees": null,
    "property_tax": null,
    "image_urls": [],
    "listing_agent_name": null,
    "listing_agency_name": null,
    "listing_agency_phone": null,
    "listing_agent_email": null,
    "listing_date": null,
    "MLS_number": null,
    "price_history": [],
    "description": "",
    "property_status": "Canceled",
    "nearby_schools": [
      "R Howell Elementary School",
      "E. A. Cox Middle School",
      "Columbia Central High School",
      "Northfield Academy",
      "Virtual Academy of Maury County",
      "Columbia Academy",
      "Calvary Baptist Academy"
    ]
  }
]

---

🚀 Use Cases

• 📊 Real Estate Analytics — Build comparative market analysis datasets
• 🧱 Property Investment Tools — Power valuation models with fresh listing data
• 🔄 ETL / Data Pipelines — Feed CRMs, dashboards, or BI tools
• 🕵️ Market Monitoring — Track property changes, status updates, agent listings
• 🏢 Brokerage Automation — Auto-sync Compass listings into internal platforms
• 🎓 Academic & Research — Housing market studies, affordability research

---

✅ Best Practices

• Use RESIDENTIAL proxies for large batches of URLs
• Avoid sending broken or redirected URLs
• For highest accuracy, limit batches to 500 URLs per run
• Schedule runs on Apify to keep datasets continuously updated
• Save outputs to Dataset + integrate via API for seamless automation

---

📚 Additional Tips

• The actor handles off-market, canceled, or sold listings gracefully
• For custom formats (CSV, Excel, API-ready JSON), DataWizards can provide tailored solutions
• Rate-limit Compass to avoid temporary blocking

---

🤝 Support

Need customization? Cleaner output? More fields? DataWizards are ready whenever you are!

📧 Email: hello.datawizard@gmail.com ✉️ Support Email Subject: Compass Urls Spider – Support Request 🔗 Connect with us: https://linkedin.com/in/data-wizards-aa8080342

---

🐛 Bugs, Improvements & Custom Requests

If you’d like additional fields, a simplified output, or have found a bug:

📩 Email: hello.datawizard@gmail.com 🛠️ Subject: Bug Report – Compass Urls Spider

DataWizards can also build custom scrapers, full automation pipelines, or enterprise-grade datasets upon request.

---

🧰 Need Something More?

Whether you need:

• A larger real-estate dataset
• A multi-site property aggregator
• A custom API built on top of Compass data
• Or simply more fields added to this actor

—we’ve got you covered.

DataWizards = reliable, scalable, and always ready to help.

---

🏁 Start extracting Compass property data smarter, faster, and with unmatched accuracy using Compass Urls Spider.

---