homes.com APIhomes.com ↗
Access Homes.com listings, rental properties, and agent profiles via API. Search by location, filter by property type, and retrieve detailed facts and reviews.
curl -X GET 'https://api.parse.bot/scraper/01f9a261-e666-4d65-9cdf-cd5351f7f592/search_agents?page=1&location=Austin%2C+TX' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for real estate agents by location (city and state). Returns a paginated list of agents with their contact info, brokerage, sales stats, and profile URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| locationrequired | string | City and state to search (e.g. 'Seattle, WA', 'Austin, TX') |
{
"type": "object",
"fields": {
"page": "integer echoing the current page number",
"agents": "array of agent objects with name, profile_url, agent_id, phone, brokerage, total_sales, local_sales, price_range, photo_url",
"location": "string echoing the input location",
"total_count": "integer total number of agents matching the location"
},
"sample": {
"data": {
"page": 1,
"agents": [
{
"name": "John Doe",
"phone": "+1 (555) 012-3456",
"agent_id": "glcxpex",
"brokerage": "AQUA Real Estate",
"photo_url": "https://imagescdn.homes.com/i2/sAjx-lru_fF4JHUOUkxnHmctQZMacKIYAxlyUFfGi64/117/john-doe.jpg?p=1",
"local_sales": "15 in Seattle",
"price_range": "$465K - $1.4M Price Range",
"profile_url": "https://www.homes.com/real-estate-agents/john-doe/glcxpex/",
"total_sales": "174 Total Sales"
}
],
"location": "Seattle, WA",
"total_count": 624
},
"status": "success"
}
}About the homes.com API
The Homes.com API exposes 6 endpoints covering property listings for sale and rent, agent search, and detailed agent profiles — all queryable by city and state. The search_properties_for_sale endpoint returns paginated listings with price, beds, baths, square footage, and listing agent info. The search_agents endpoint surfaces agent contact details, brokerage affiliation, sales volume, and price range across any U.S. market.
Property Search
The search_properties_for_sale and search_properties_for_rent endpoints both accept a location string (e.g. 'Austin, TX') and an optional property_type filter with accepted values of houses, townhouses, condos, land, or mobile. Each returns a listings array where every object includes address, price, beds, baths, sqft, agent, brokerage, and a direct url to the listing. Pagination is handled via the page parameter. The mode field in the response is always 'sale' or 'rent', confirming which endpoint was called.
Property Details
get_property_details takes a full Homes.com property URL — typically sourced from a prior search result — and returns the address, price, description, and a facts object containing fields like price_per_sq_ft, year_built, and lot_size. This endpoint is the right choice when you need the full property write-up rather than the summary fields from search results.
Agent Search and Profiles
search_agents queries agents by location and returns an array of agent objects with name, phone, brokerage, total_sales, local_sales, price_range, photo_url, and a profile_url. The total_count field tells you how many agents match that market without paginating through all results. To fetch a full agent profile, pass the agent_id and name_slug (both available from search results) into get_agent_profile, which returns a bio, specialties array, neighborhoods_served array, and a reviews array with user-submitted feedback. A separate get_total_agent_count endpoint returns the platform-wide count of listed agents as a string.
- Build an agent comparison tool using
total_sales,local_sales, andprice_rangefromsearch_agents - Populate a neighborhood property feed by calling
search_properties_for_salewith city/state and filtering byproperty_type - Enrich a CRM with agent bios, specialties, and neighborhoods served from
get_agent_profile - Track rental inventory across multiple cities by paginating
search_properties_for_rentresults - Display full listing detail pages using
description,facts, andpricefromget_property_details - Aggregate agent review sentiment by pulling the
reviewsarray fromget_agent_profilefor multiple agents in a market - Monitor total agent supply in a region using
get_total_agent_countandtotal_countfromsearch_agents
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Homes.com have an official developer API?+
What does `get_agent_profile` return beyond what `search_agents` provides?+
search_agents returns summary fields: name, phone, brokerage, sales counts, price range, and a profile URL. get_agent_profile adds a written bio, a specialties array, a neighborhoods_served array, and a full reviews array with individual user reviews. You need both the agent_id and name_slug from the search result to call the profile endpoint.Can I search properties by ZIP code or MLS number?+
location string in city-and-state format (e.g. 'Seattle, WA'). ZIP code, MLS number, and coordinates are not supported as input filters. You can fork this API on Parse and revise it to add a ZIP-based or MLS lookup endpoint.What property facts are available from `get_property_details`?+
facts object can include price_per_sq_ft, year_built, and lot_size, alongside top-level fields for address, price, and description. The exact subset of facts returned depends on what the individual listing includes; not every listing will have all three fact fields populated.