MLS Scraper - Direct MLS Data (BYOK)

Access direct MLS data with your own credentials by John Rippy | johnrippy.link

---

Bring Your Own Keys (BYOK)

This actor lets you connect to your MLS board's data feed using your own credentials. Get real-time listing data, off-market properties, and data not available on public sites.

Why Direct MLS Access?

Feature	Public Sites (Zillow, etc.)	Direct MLS
Data freshness	15min - 24hr delay	Real-time
Off-market listings	❌ Not available	✅ Available
Coming soon listings	❌ Rarely	✅ Yes
Full agent info	Partial	✅ Complete
Price history	Limited	✅ Full history
Custom fields	❌ No	✅ All MLS fields
Rate limits	Aggressive	Your allocation

---

Supported MLS Systems

API Types

API Type	Description	Common Providers
RETS	Traditional MLS standard	Most regional MLSs
Web API	Modern REST API	Newer MLS systems
RESO Web API	RESO-compliant REST	CRMLS, Bright MLS, etc.
Spark API	FBS Data Services	Various boards
Bridge API	Bridge Interactive	Multiple MLSs

Major MLS Boards

• CRMLS (California)
• Bright MLS (Mid-Atlantic)
• NWMLS (Pacific Northwest)
• MRED (Midwest)
• ARMLS (Arizona)
• HAR (Houston)
• REcolorado
• And 500+ more...

---

Getting Your Credentials

Step 1: MLS Membership

You need an active MLS membership or IDX agreement with your board.

Step 2: Request API Access

Contact your MLS to request:

• RETS credentials (username/password + login URL)
• OR Web API access (API key + endpoint URL)
• OR OAuth access (client credentials)

Step 3: Configure This Actor

Enter your credentials in the input settings.

---

Quick Start Examples

Example 1: Demo Mode (Free Testing)

{
  "demoMode": true
}

Example 2: RETS Connection

{
  "mlsProvider": "CRMLS",
  "apiType": "rets",
  "apiUrl": "https://rets.yourmls.com/Login",
  "username": "your_rets_username",
  "password": "your_rets_password",
  "city": "Los Angeles, CA",
  "listingStatus": "active",
  "maxResults": 100
}

Example 3: RESO Web API

{
  "mlsProvider": "Bright MLS",
  "apiType": "reso_web_api",
  "apiUrl": "https://api.brightmls.com/reso/odata/Property",
  "accessToken": "your_oauth_access_token",
  "county": "Montgomery",
  "priceMin": 500000,
  "priceMax": 1000000
}

Example 4: Incremental Sync

{
  "mlsProvider": "NWMLS",
  "apiType": "web_api",
  "apiUrl": "https://api.nwmls.com/v2/listings",
  "apiKey": "your_api_key",
  "modifiedSince": "2024-12-20",
  "maxResults": 1000
}

---

Input Parameters

Authentication

Parameter	Type	Required	Description
demoMode	boolean	No	Run with sample data (free testing)
mlsProvider	string	No	Your MLS board name
apiType	string	No	API type: rets, web_api, reso_web_api, spark_api, bridge_api
apiUrl	string	Yes*	Your MLS API endpoint
username	string	Yes*	RETS/API username
password	string	Yes*	RETS/API password
apiKey	string	Yes*	API key (if required)
accessToken	string	Yes*	OAuth access token (for RESO)

*At least one authentication method required (unless using demoMode)

Location Filters

Parameter	Type	Description
city	string	City to search (e.g., "San Francisco, CA")
zipCode	string	ZIP code
county	string	County name
mlsArea	string	MLS-specific area code

Property Filters

Parameter	Type	Description
priceMin	integer	Minimum price
priceMax	integer	Maximum price
bedsMin	integer	Minimum bedrooms
bathsMin	integer	Minimum bathrooms
sqftMin	integer	Minimum square feet
sqftMax	integer	Maximum square feet
propertyTypes	array	residential, condo, townhouse, multi_family, land, commercial
listingStatus	string	active, pending, sold, expired, withdrawn, coming_soon, off_market
daysOnMarketMax	integer	Max days on market

Date Filters

Parameter	Type	Description
listingDateFrom	string	Listings from this date (YYYY-MM-DD)
listingDateTo	string	Listings until this date
modifiedSince	string	Only listings modified since (for incremental syncs)

Output Options

Parameter	Type	Default	Description
includePhotos	boolean	true	Include photo URLs
includeHistory	boolean	false	Include price history
includeAgent	boolean	true	Include agent/office info
maxResults	integer	100	Maximum listings (1-10000)

---

Output Format

{
  "mlsNumber": "MLS-2024-001234",
  "platform": "mls",
  "addressNormalized": "123 MAIN ST, SAN FRANCISCO, CA 94102",
  "addressRaw": "123 Main Street, San Francisco, CA 94102",
  "city": "San Francisco",
  "state": "CA",
  "zipCode": "94102",
  "county": "San Francisco",
  "price": 1350000,
  "originalPrice": 1395000,
  "status": "active",
  "beds": 3,
  "baths": 2,
  "sqft": 1850,
  "yearBuilt": 1925,
  "propertyType": "residential",
  "listingDate": "2024-12-10",
  "daysOnMarket": 14,
  "description": "Stunning Victorian home...",
  "features": ["Hardwood Floors", "Fireplace", "..."],
  "photos": ["https://..."],
  "virtualTour": "https://...",
  "latitude": 37.7751,
  "longitude": -122.4193,
  "agent": {
    "name": "Sarah Johnson",
    "phone": "(415) 555-0123",
    "email": "sarah@realty.com",
    "brokerage": "Premier Realty"
  },
  "priceHistory": [
    { "date": "2024-12-10", "price": 1395000, "event": "Listed" },
    { "date": "2024-12-17", "price": 1350000, "event": "Price Change" }
  ],
  "taxInfo": {
    "annualAmount": 14500,
    "assessedValue": 980000
  },
  "hoa": {
    "fee": 0,
    "frequency": "none"
  },
  "scrapedAt": "2024-12-24T12:00:00Z"
}

---

Use Cases

Real Estate Investors

• Access coming soon and off-market listings
• Get real-time price changes
• Track days on market trends

Real Estate Agents

• Build custom MLS search tools
• Automate CMA (Comparative Market Analysis)
• Sync listings to your website

Proptech Companies

• Build property databases
• Power search applications
• Analyze market trends

Market Researchers

• Comprehensive market data
• Historical price analysis
• Inventory tracking

---

Pricing

Event	Cost
Per listing scraped	$0.05
Demo mode	Free

Why Pay-Per-Listing?

MLS data is valuable and access is limited. This pricing model:

• Aligns cost with value received
• No monthly fees when not using
• Scale up/down based on needs

---

Part of the Real Estate Scraper Suite

Actor	Description	Status
zillow-scraper	Zestimate, tax history	✅ Available
redfin-scraper	Agent data, accurate sqft	✅ Available
realtor-scraper	Comprehensive photos	✅ Available
real-estate-aggregator	Combine all 3 + deduplicate	✅ Available
mls-scraper	Direct MLS data (BYOK)	✅ You're here!

---

FAQ

Do I need MLS membership?

Yes, or an IDX agreement that includes API access.

Which MLS boards are supported?

Any MLS that provides RETS or Web API access. Most major boards do.

Can I use this without credentials?

Yes! Use demoMode: true to see sample output and test your integration.

How do I get API credentials?

Contact your MLS board's IT department or member services. Mention you need RETS or Web API access.

Is this data licensed for redistribution?

Depends on your MLS agreement. Most IDX agreements have display rules. Check with your board.

Can Apify access my MLS?

Most MLS APIs are IP-restricted. You may need to whitelist Apify's IP ranges or use a proxy configuration.

---

Support

• LinkedIn: John Rippy
• Website: johnrippy.link

---

Built by John Rippy | johnrippy.link

---

Keywords

mls scraper, mls api, rets scraper, real estate data api, mls listing scraper, direct mls access, byok mls, mls board data, reso web api, real estate api, property listing api, mls data feed, mls integration, real estate automation, mls data extraction, off-market listings, coming soon listings, mls property data