Skip to main content

​
Realtor Scraper API

Search for-sale, for-rent, sold, and pending listings, pull full property detail with price and tax history, schools, and agent contacts, and autocomplete locations across realtor.com (US) and realtor.ca (Canada) — a unified real-estate API over both markets. The API handles authentication, anti-bot bypass, and market routing automatically.

​
Key Features

Dual Coverage

One API over realtor.com (US, USD) and realtor.ca (Canada, CAD). Pick a market with the market parameter.

Rich Property Data

Beds, baths, sqft, lot size, year built, HOA, price-per-sqft, coordinates, photos, videos, and virtual tours.

History & Estimates

Full price history, tax history, and value estimates on the /v1/realtor/properties/{id} detail endpoint.

Schools & Agents

Nearby schools with ratings, plus agent/office/broker contact details (name, email, phones).

Anti-Bot Bypass

Automatic session management, Chrome TLS impersonation, and fingerprint rotation to avoid blocks.

Country Proxies

Requests are routed through proxies matching the target market for accurate listings and availability.
realtor.ca (Canada) caps bounding-box searches at roughly 600 results per box. For dense metros, split large areas into smaller lat_min/lat_max/lng_min/lng_max tiles.

​
Supported Markets

The API covers two national real-estate portals. Use the market query parameter to target one.
MarketPortalCountryCurrencyLocale
:us: usrealtor.comUSUSDen-US
:canada: carealtor.caCACADen-CA
If no market is specified, it defaults to us. Use the /v1/realtor/markets endpoint to get the full list (with domain, currency, and locale) programmatically.

​
Quick Start

import ScrapeBadger from "scrapebadger";

const client = new ScrapeBadger({ apiKey: "YOUR_API_KEY" });

const results = await client.realtor.search({
  location: "Austin, TX",
  market: "us",
  status: "for_sale",
});

console.log(results.results);

​
Endpoints

EndpointMethodDescription
/v1/realtor/searchGETSearch a market for listings
/v1/realtor/properties/{property_id}GETFull detail for a single property
/v1/realtor/autocompleteGETLocation autocomplete suggestions
/v1/realtor/marketsGETList all supported markets

​
Credit Costs

EndpointCost
Search8 credits
Get property detail10 credits
Autocomplete2 credits
List markets0 credits
Failed requests0 credits

​
Authentication

All requests require your API key in the X-API-Key header: 
curl "https://scrapebadger.com/v1/realtor/search?location=Miami,+FL" \
  -H "X-API-Key: YOUR_API_KEY"

​
Anti-Bot Handling

Both realtor.com and realtor.ca protect their listings with IP-reputation scoring, TLS/HTTP-2 fingerprinting, and server-side rendering. ScrapeBadger clears these automatically using Chrome TLS impersonation on sessions matched to the target market. You never need to manage proxies, sessions, or CAPTCHAs.
For accurate listings and availability, requests are routed through proxies in the market’s country. This is handled automatically based on the market parameter.

​
Rich Datapoints

Every property carries a deep set of structured fields:
GroupFields
Pricinglist_price, list_price_formatted, price_per_sqft, price_reduced_amount, hoa_fee, last_sold_price
Sizebeds, baths, baths_full, baths_half, sqft, lot_sqft, year_built, stories, garage, rooms, parking_spaces
Locationaddress (line, city, state, postal, county, neighborhood), coordinate (lat/lon)
Mediaprimary_photo, photos[], photo_count, videos[], virtual_tours[]
Historyprice_history[], tax_history[], estimates[], days_on_market, last_sold_date_at
Contextschools[], amenities[], details[], open_houses[], agents[], flags (new/pending/foreclosure/…)
Search returns each result as a Property; the property detail endpoint returns a PropertyDetail that adds details, amenities, tax_history, price_history, schools, and estimates.

​
Next Steps

Search Listings

Full API reference for searching the realtor.com / realtor.ca catalogs

Property Detail

Retrieve full detail, price/tax history, schools, and agents for a property