
Global Sources Supplier Scraper
scrape.ly/store/cornerledger/globalsources-scraperLead generationE-commerce
2 monthly users

Scrape HAR.com, the Texas MLS portal: homes for sale and for rent, sold and leased homes with final sold prices, and the agent directory. Price, beds, baths, sqft, GPS, MLS number, agent, brokerage phone and email. No login.
Pull Texas property data from HAR.com, the Houston Association of REALTORS® portal that lists homes across the whole state. Get homes for sale, for rent, recently sold and leased homes with the final sold price and date, or the agent directory with phone numbers. Search by city, county, area or zip, or paste any HAR.com URL. No login, no browser, and 1,000 listings arrive in about 10 seconds.
| Field | What it does |
|---|---|
listingType | sale, rent, sold, leased or agents |
locations | Texas cities, counties, areas or 5-digit zips, one search each |
startUrls | HAR.com search, property (/homedetail/...) or agent search URLs |
maxItems | Results to save in total (0 = no limit) |
maxItemsPerLocation | Optional cap per location or URL |
minPrice / maxPrice | List price, monthly rent or sold price |
propertyTypes | Single-family, townhouse / condo, high-rise condo, multi-family, lots, acreage |
minBeds, minBaths, minSqft, minYearBuilt, ... | Size and age filters (each has a max too) |
soldWithin | Sold and Leased modes: last 6 months, 1, 2 or 5 years |
newConstruction, hasPool, priceReduced, hasOpenHouse, waterfront, foreclosure | Listing flags |
includeDetails | Adds description, all photos, features and home valuations |
agentName, agentSort | Agents mode: name filter and order |
{
"listingType": "sale",
"locations": ["Houston", "77008"],
"minPrice": 300000,
"maxPrice": 900000,
"minBeds": 3,
"propertyTypes": ["single-family"],
"maxItems": 500
}
| Field | Description |
|---|---|
listingType, status | sale, rent, sold, leased; For Sale, Coming Soon, Pending, Sold, Leased... |
mlsNumber, harId, listingId | MLS number and HAR.com ids |
address, city, state, zip, subdivision, marketArea | Location |
latitude, longitude | GPS coordinates |
price, originalPrice, pricePerSqft | List price (or monthly rent) |
soldPrice, soldDate, soldPricePerSqft, soldPriceRange | Closing data (Sold and Leased modes) |
beds, bathsFull, bathsHalf, sqft, lotSize, acres, yearBuilt, stories | Size and age |
propertyType, style, garageSpaces, pool, newConstruction, foreclosure | Attributes |
daysOnMarket, hoaFee, taxAmount, hasOpenHouse, has3dTour | Listing signals |
photo, photosCount, videosCount | Media |
agentName, agentId, agentUrl, brokerName, brokerPhone, brokerEmail | Listing agent and brokerage |
description, photos, features, valuations, estimatedValue, appraisalValue, county | With includeDetails |
url | HAR.com property page |
searchInput | The location or URL that found the row |
Example (a home for sale; agent and brokerage contact details changed):
{
"listingType": "sale",
"mlsNumber": "32504628",
"harId": "2974012",
"status": "Coming Soon",
"address": "1509 Allston St",
"city": "Houston",
"state": "TX",
"zip": "77008",
"subdivision": "Houston Heights",
"marketArea": "Heights/Greater Heights",
"latitude": 29.798491,
"longitude": -95.400544,
"price": 1150000,
"pricePerSqft": 532,
"beds": 3,
"bathsFull": 2,
"bathsHalf": 1,
"sqft": 2160,
"lotSize": 6600,
"yearBuilt": 1906,
"stories": 2,
"garageSpaces": 2,
"propertyType": "Single-Family",
"style": "English,Victorian",
"daysOnMarket": 1,
"taxAmount": 21227,
"photo": "https://mediahar.harstatic.com/818270248/hr/818273752.jpeg",
"photosCount": 25,
"agentName": "Jane Example",
"brokerName": "Example Realty Group",
"brokerPhone": "713-555-0100",
"brokerEmail": "office@example.com",
"url": "https://www.har.com/homedetail/1509-allston-st-houston-tx-77008/2974012"
}
A sold home adds the closing data:
{
"listingType": "sold",
"status": "Sold",
"address": "1405 W 21st St A",
"city": "Houston",
"zip": "77008",
"price": 579000,
"soldPrice": 550000,
"soldDate": "2026-10-08",
"soldPricePerSqft": 229.17,
"soldPriceRange": "$482,001 - $552,000",
"beds": 3,
"sqft": 2400,
"yearBuilt": 2026
}
With Include full property details each home also gets description, photos, a features object (rooms, kitchen, interior, roof, foundation, heating and cooling, HOA, legal description, financing) and valuations:
{
"estimatedValue": 983000,
"appraisalValue": 998830,
"county": "Harris County",
"valuations": {
"ice": {"value": 983000, "low": 796230, "high": 1169770, "confidencePct": 81, "deviationPct": 19},
"cotality": {"value": 714200, "low": 655400, "high": 773000, "confidencePct": 87, "deviationPct": 8},
"appraisalDistrict": {"value": 998830}
}
}
An agent row (Agents mode; fictional person):
{
"listingType": "agents",
"agentName": "Jane Example",
"agentId": "janeexample",
"phone": "(713) 555-0100",
"brokerName": "Example Realty Group",
"officeCity": "Houston",
"officeZip": "77040",
"platinum": true,
"soldCount": 449,
"leasedCount": 56,
"showingsCount": 55,
"agentUrl": "https://www.har.com/jane-example/agent_janeexample"
}
Example: 1,000 Houston homes for sale ≈ $3.25, or ≈ $3.85 with full details.
Is it legal to scrape HAR.com? The actor only reads public pages that anyone can open without an account. You are responsible for using the data in line with HAR.com's terms, MLS rules and privacy laws such as the CCPA.
Do I need a login or my own proxy? No. The datacenter proxy that is on by default works. If HAR.com starts refusing it, the run moves to US residential exits by itself.
How many results can I get?
As many as HAR.com has. A single search on HAR.com stops at 10,000, so larger requests are split into price bands automatically. Set maxItems to 0 for no limit.
Which areas are covered? Everything HAR.com lists: Houston and its suburbs, and other Texas markets such as Dallas–Fort Worth, Austin and San Antonio. Type a city, county, area, neighbourhood or zip code.
Why is a field empty? HAR.com leaves some fields blank for some listings (HOA fee, lot size for condos, brokerage email). The actor never invents values. Sold prices are only in Sold and Leased modes.
Can I schedule it or use the API? Yes. Schedule runs in the console, or start them and read the dataset through the Scrapely API or SDKs.
Every field below can be set in the run form, passed through the API, or saved as a task. Unset fields fall back to the defaults shown.
listingTypeenumOptionaldefault "sale"What to scrape
Homes for sale, homes for rent, recently sold homes (with the final sold price and date), recently leased homes, or the HAR.com real-estate agent directory.
locationsarrayOptionalLocations (Texas city, area, county or zip)
Texas places to search: a city (Houston, Sugar Land), a county (Harris County), a market area or neighbourhood (The Heights) or a 5-digit zip code (77008). One search runs per location. In Agents mode a city or zip is the agent's office location. Leave empty when you paste HAR.com URLs below.
startUrlsarrayOptionalHAR.com URLs
Paste HAR.com search pages (https://www.har.com/houston/realestate/for_sale, or any search with filters and a drawn map area copied from your browser), property pages (https://www.har.com/homedetail/...), or agent searches (https://www.har.com/realestatepro/search?...). Filters already in a URL are kept.
maxItemsintegerOptionaldefault 20Maximum results
How many results to save in total across all locations and URLs. 0 means no limit: the run pages through everything HAR.com returns.
maxItemsPerLocationintegerOptionalMaximum results per location or URL
Optional cap for each location or search URL, so one big city does not use up the whole run. Empty or 0 means no per-location cap.
Optional. They apply to searches by location and are added to pasted search URLs that do not set them already.
minPriceintegerOptionalMinimum price
Lowest list price (for sale), monthly rent (for rent) or sold price (sold and leased).
maxPriceintegerOptionalMaximum price
Highest list price, monthly rent or sold price.
propertyTypesarrayOptionalProperty types
Only these property types. Leave empty for all.
minBedsintegerOptionalMinimum bedrooms
At least this many bedrooms.
maxBedsintegerOptionalMaximum bedrooms
At most this many bedrooms.
minBathsintegerOptionalMinimum full bathrooms
At least this many full bathrooms.
maxBathsintegerOptionalMaximum full bathrooms
At most this many full bathrooms.
minSqftintegerOptionalMinimum living area (sqft)
Smallest building size in square feet.
maxSqftintegerOptionalMaximum living area (sqft)
Largest building size in square feet.
minLotSizeintegerOptionalMinimum lot size (sqft)
Smallest lot in square feet.
maxLotSizeintegerOptionalMaximum lot size (sqft)
Largest lot in square feet.
minYearBuiltintegerOptionalBuilt in or after
Earliest year built.
maxYearBuiltintegerOptionalBuilt in or before
Latest year built.
minPricePerSqftintegerOptionalMinimum price per sqft
Lowest price per square foot.
maxPricePerSqftintegerOptionalMaximum price per sqft
Highest price per square foot.
maxHoaFeeintegerOptionalMaximum HOA fee per month
Highest monthly HOA / maintenance fee (0 = no HOA fee).
maxDaysOnMarketintegerOptionalMaximum days on market
Only listings on the market for at most this many days (e.g. 7 for new listings).
soldWithinenumOptionaldefault "1-year"Sold or leased within
Sold and Leased modes: how far back to look.
newConstructionbooleanOptionaldefault falseNew construction only
Only new or recently built homes.
hasPoolbooleanOptionaldefault falsePrivate pool
Only homes with a private pool.
priceReducedbooleanOptionaldefault falsePrice reduced
Only listings with a recent price cut.
hasOpenHousebooleanOptionaldefault falseOpen house
Only listings with a scheduled open house.
waterfrontbooleanOptionaldefault falseWaterfront
Only waterfront properties.
foreclosurebooleanOptionaldefault falseForeclosures
Only foreclosure / distressed listings.
hasHalfBathbooleanOptionaldefault falseHas a half bath
Only homes with at least one half bathroom.
keywordsstringOptionalKeywords
Words that must appear in the listing, e.g. "study" or "guest house".
extraFiltersobjectOptionalAdvanced HAR.com filters
Any other HAR.com search filter as parameter -> value pairs, using the names from a HAR.com search URL, e.g. {"garage_num": "2", "stories": "1", "waterview": "1"}.
sortByenumOptionaldefault "newest"Sort listings by
Order of for-sale and for-rent results. A sort in a pasted URL wins.
includeDetailsbooleanOptionaldefault falseInclude full property details
Open each property page to add the full description, every photo, dozens of features (rooms, interior, roof, heating, HOA, legal description, financing) and home valuations (ICE, Cotality and appraisal district values). Charged as an extra event per property.
Used when 'What to scrape' is Agents.
agentNamestringOptionalAgent name
Agents mode: only agents whose name matches.
agentSortenumOptionaldefault "most-sold"Sort agents by
Agents mode: order of agents.
agentsWithRatingsOnlybooleanOptionaldefault falseOnly agents with client ratings
Agents mode: skip agents without client reviews.
proxyConfigurationobjectOptionaldefault {"useScrapelyProxy":true,"scrapelyProxyGroups":["DATACENTER…Proxy configuration
Datacenter proxies work for most runs; the actor switches to US residential exits by itself if HAR.com keeps refusing them.
Every run writes its results to a dataset. Preview it in the dashboard, then export it or read it through the API.
| Field | Type | Description |
|---|---|---|
| photo | any | Photo |
| address | any | Address |
| city | any | City |
| zip | any | Zip |
| price | any | Price |
| soldPrice | any | Sold price |
| soldDate | any | Sold on |
| beds | any | Beds |
| bathsFull | any | Full baths |
| bathsHalf | any | Half baths |
| sqft | any | Sqft |
| yearBuilt | any | Built |
| propertyType | any | Type |
| status | any | Status |
| daysOnMarket | any | Days on market |
| agentName | any | Agent |
| brokerName | any | Brokerage |
| url | any | HAR.com page |
You pay for the events the actor reports, such as each result or page it produces. Platform usage is included in the event prices.
| Event | Charged when | Price |
|---|---|---|
| Property details | Full property page added to a home: description, all photos, features and home valuations. Only when 'Include full property details' is on. | $0.0005 |
| Result | One home (for sale, for rent, sold or leased) or one agent saved to the dataset. | $0.0032 |
Run this actor from your own code. Swap in your API token and the examples work as-is.
import { ScrapelyClient } from 'scrapely-client'
const client = new ScrapelyClient({ token: process.env.SCRAPELY_TOKEN })
// Start the actor and wait for the run to finish.
const run = await client.actor('roamandroof/har-scraper').call({
"listingType": "sale",
"locations": [
"Houston"
],
"maxItems": 20,
"proxyConfiguration": {
"useScrapelyProxy": true,
"scrapelyProxyGroups": [
"DATACENTER"
]
}
})
// Read the dataset the run produced.
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)Tokens live in your account settings. Keep them server-side: a token carries the full permissions of your account.
Connect the Scrape.ly MCP server once and your agent can run this actor as a tool. Pick your tool:
Fetch scrape.ly/agents.md and run roamandroof/har-scraperPaste into Claude Code, Codex, Cursor or any AI agent. It signs you in once in the browser.
{
"mcpServers": {
"scrapely": {
"url": "https://api.scrape.ly/mcp?tools=actors,runs,storage,docs&actors=roamandroof/har-scraper"
}
}
}No key in the file: your client opens the browser to sign you in the first time it connects.
Inputs the developer prepared for common jobs. Open one to see its input, then copy it to your account to run it as-is or adjust it.
Final sold price, closing date and sold price per sqft from the last year.
Paste any HAR.com search page; its filters and map area are kept.
Monthly rent, beds, baths, sqft, agent and brokerage.
What homes actually rented for, with the lease date.
Description, every photo, dozens of features and ICE, Cotality and appraisal values.
Price, bedroom and property-type filters, cheapest first.
Agent name, phone, brokerage, office zip and sold/leased counts.
Compare several zips or cities with a cap per location.
Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes. The advantage lasts forever.