Homes API

Overview

The Homes API allows users to input a property URL and get detailed property information in return, such as price, location, size, and amenities. It provides an easy way to access all relevant property details quickly and accurately.

Authentication

Visit our Authentication Docs on learning how to get started on integrating this API in your application.

Endpoint

GET https://get.scrapehero.com/api/homes/pdp-details/?x-api-key=<YOUR_API_KEY>&url=https://www.homes.com/property/75550-calle-del-sur-indian-wells-ca/f05f451b9pz3c/

Request Parameters

Parameter	Type	Required	Description
url	string	Yes	Property URL

Response Format

The API returns data in JSON format. Here's an example of the response structure:

{
  "query": {
	"input": "https://www.homes.com/property/75550-calle-del-sur-indian-wells-ca/f05f451b9pz3c/"
  },
  "propertydata": {
	"beds": "2",
	"baths": "2",
	"year_build": "1964",
	"mls_key": "2xs3jm9",
	"estimate_annual_tax": "$8,171",
	"listing_type": null,
	"listing_date": "03/16/2021",
	"hoa": "$575",
	"area": "1,530 Sq Ft",
	"property_type": "Condominium",
	"days_on_market": "20",
	"community_details": "Overview: Association fees include clubhouse, Casa Dorado Subdivision, Greenbelt, Planned Unit Development | Amenities: Clubhouse | Recreation: Tennis Courts, Community Pool, Community Spa | PetPolicy: Pet Restriction | Security: Card or Code Access, Gated Community",
	"neighbourhood_attributes": null,
	"most_recent_tax_assessment_detail": {
  	"Year": "2023",
  	"Tax Paid": "$8,171",
  	"Tax Assessment": "$559,735",
  	"Land": "$197,676",
  	"Improvement": "$362,059"
	},
	"address": "75550 Calle Del Sur, Indian Wells, CA, 92210",
	"latitude": 33.71833,
	"longitude": -116.34628,
	"city": "Indian Wells",
	"price": "$634,724",
	"min_price": null,
	"max_price": null,
	"land_area": null,
	"images": [
  	"https://images.homes.com/listings/102/9734968771-473563101/75550-calle-del-sur-indian-wells-ca-primaryphoto.jpg",
  	"https://images.homes.com/listings/214/0834968771-473563101/75550-calle-del-sur-indian-wells-ca-buildingphoto-2.jpg",
  	"https://images.homes.com/listings/214/1834968771-473563101/75550-calle-del-sur-indian-wells-ca-buildingphoto-3.jpg",
  	"https://images.homes.com/listings/214/2834968771-473563101/75550-calle-del-sur-indian-wells-ca-buildingphoto-4.jpg",
  	"https://images.homes.com/listings/214/3834968771-473563101/75550-calle-del-sur-indian-wells-ca-buildingphoto-5.jpg",
  	"https://images.homes.com/listings/214/4834968771-473563101/75550-calle-del-sur-indian-wells-ca-buildingphoto-6.jpg",
  	"https://images.homes.com/listings/214/5834968771-473563101/75550-calle-del-sur-indian-wells-ca-buildingphoto-7.jpg"
	],
	"estimate_mortgage": "$4,734",
	"description": "About This Home As of April 2021 Views, Views Views! Welcome to Case Dorado in Indian Wells. This 2 bedroom 2 bathroom unit is absolutely stunning, recently remodeled with a modern flare and is move-in ready! One of the finest developments in the desert. Casa Dorado has 116 units on 26 acres of land with 6 pools, 2 tennis courts, 4 hole pitch & Putt and 2 putting greens. With the Indian Wells resident card enjoy the golf course in IW for 55.00, fitness center and discounts at the IW restaurants. Don't miss out!",
	"listing_details": [
  	{
    	"Property Type": "Residential"
  	},
  	{
    	"Property Sub Type": "Condominium"
  	},
  	{
    	"Property Attached/Detached": "Yes"
  	},
  	{
    	"Levels": "Ground Level, No Unit Above"
  	},
  	{
    	"Building Number Of Stories": "1"
  	},
  	{
    	"List Price per Sq Ft": "325.49"
  	},
  	{
    	"Lp Sp Ratio": "1.0800"
  	},
  	{
    	"View Type": "Mountain(s), Park/Green Belt"
  	},
  	{
    	"Year Built": "1964"
  	},
  	{
    	"Co Selling Member Address": "74-990 Highway 111, Indian Wells, CA 92210"
  	},
  	{
    	"Co Selling Office Address": "74-990 Highway 111, Indian Wells, CA 92210"
  	},
  	{
    	"Co Selling Office Fax": "(760) 777-7571"
  	},
  	{
    	"Listing I D": "219058927"
  	},
  	{
    	"Listing Member Address": "78000 Fred Waring Dr.,, Ste. 205, Palm Desert, CA 92211"
  	},
  	{
    	"Listing Member Fax": "(760) 262-3232"
  	},
  	{
    	"Listing Office Address": "78000 Fred Waring Dr.,, Ste. 205, Palm Desert, CA 92211"
  	},
  	{
    	"Listing Office Fax": "(760) 262-3232"
  	},
  	{
    	"Selling Member Address": "74-990 Highway 111, Indian Wells, CA 92210"
  	},
  	{
    	"Selling Office Address": "74-990 Highway 111, Indian Wells, CA 92210"
  	},
  	{
    	"Selling Office Fax": "(760) 777-7571"
  	},
  	{
    	"Land Type": "Fee"
  	},
  	{
    	"New Construction": "No"
  	},
  	{
    	"Subdivision": "Casa Dorado"
  	},
  	{
    	"Special Features": "None"
  	}
	],
	"interior_features": [
  	{
    	"Appliances": "Dryer, Microwave Oven, Washer, Refrigerator, Dishwasher"
  	},
  	{
    	"Fireplace": "Yes"
  	},
  	{
    	"Fireplace Location": "Living Room"
  	},
  	{
    	"Fireplace Features": "Gas Starter"
  	},
  	{
    	"Flooring": "Carpet, Tile"
  	},
  	{
    	"Total Bedrooms": "2"
  	},
  	{
    	"Total Bathrooms": "2.00"
  	},
  	{
    	"Full Bathrooms": "2"
  	},
  	{
    	"Eating Areas": "Dining Area, Kitchen Island"
  	},
  	{
    	"Kitchen Features": "Granite Slab Counters"
  	},
  	{
    	"Estimated Sq Ft": "1530.00"
  	}
	],
	"exterior_features": [
  	{
    	"Pool": "Yes"
  	},
  	{
    	"Pool Construction": "In Ground"
  	},
  	{
    	"Pool Description": "Community, In Ground, Fenced"
  	},
  	{
    	"Pool Location": "Community"
  	},
  	{
    	"Planned Unit Development": "Yes"
  	},
  	{
    	"Spa Hot Tub": "Yes"
  	},
  	{
    	"Spa Hot Tub Construction": "In Ground"
  	},
  	{
    	"Spa Hot Tub Description": "Community"
  	},
  	{
    	"View": "Yes"
  	}
	],
	"utilities": [
  	{
    	"Cooling Type": "Air Conditioning, Central Air"
  	},
  	{
    	"Heating": "Fireplace(s), Forced Air"
  	},
  	{
    	"Security": "Card/Code Access, Gated Community"
  	},
  	{
    	"Sewer": "In, Connected and Paid"
  	}
	],
	"garage_or_parking": [
  	{
    	"Garage": "Yes"
  	},
  	{
    	"Garage Description": "Detached"
  	},
  	{
    	"Parking": "Garage Door Opener"
  	},
  	{
    	"Total Garage Spaces": "1.00"
  	},
  	{
    	"Total Parking Spaces": "1.00"
  	}
	],
	"mls_number": "219058927",
	"risk_factor_url": "https://firststreet.org/property/address/611418180_fsid?utm_source=homescom",
	"listing_agent": "Steve Enlow",
	"agent_email": "enlowhomes@yahoo.com",
	"agent_phone_number": "(760) 880-3675",
	"agent_url": "https://www.homes.com/real-estate-agents/steve-enlow/by9l79b/",
	"broker_name": "Desert Sands Realty",
	"property_url": "https://www.homes.com/property/75550-calle-del-sur-indian-wells-ca/f05f451b9pz3c/"
  }
}

Response Fields

Field	Type	Description
beds	string	beds
baths	string	baths
year_build	string	year build
mls_key	string	mls key
estimate_annual_tax	string	annual tax estimated
listing_type	string	listing type
listing_date	string	listing date
hoa	number	hoa
area	string	area
property_type	string	property type
days_on_market	string	days on market
community_details	string	community details
neighbourhood_attributes	string	neighbourhood attributes
most_recent_tax_assessment_detail	dict	most recent tax assessment detail
address	string	address
latitude	number	latitude
longitude	number	longitude
city	string	city
price	string	price
min_price	string	min price
max_price	string	max price
land_area	string	land area
images	list	images
estimate_mortgage	string	estimate mortgage
description	string	description
listing_details	list	listing details
interior_features	list	interior features
exterior_features	list	exterior features
garage_or_parking	list	garage or parking
mls_number	string	mls number
risk_factor_url	string	risk factor url
listing_agent	string	listing agent
agent_email	string	agent email
agent_phone_number	string	agent phone number
agent_url	string	agent url
broker_name	string	broker name
Property_url	string	Property url

Usage Example

Here's an example of how to use the API with Python:

JavaScript
Python
Java
Ruby

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "get.scrapehero.com",
  "port": null,
  "path": "/api/homes/pdp-details/?x-api-key=<YOUR_API_KEY>&url=https://www.homes.com/property/75550-calle-del-sur-indian-wells-ca/f05f451b9pz3c/",
  "headers": {}
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

import http.client

conn = http.client.HTTPSConnection("get.scrapehero.com")

conn.request("GET", "/api/homes/pdp-details/?x-api-key=<YOUR_API_KEY>&url=https://www.homes.com/property/75550-calle-del-sur-indian-wells-ca/f05f451b9pz3c/")

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

HttpResponse<String> response = Unirest.get("https://get.scrapehero.com/api/homes/pdp-details/?x-api-key=<YOUR_API_KEY>&url=https://www.homes.com/property/75550-calle-del-sur-indian-wells-ca/f05f451b9pz3c/")
  .asString();

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://get.scrapehero.com/api/homes/pdp-details/?x-api-key=<YOUR_API_KEY>&url=https://www.homes.com/property/75550-calle-del-sur-indian-wells-ca/f05f451b9pz3c/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

This API uses 10 data credit per API call. Learn more about data credits.

Rate Limits

Rate limits are based off the plan that you have subscribed to. To learn more about the plan specification vist our Plans page.

Response Codes

Check out the response codes here.

Best Practices

Use appropriate error handling in your code.
Implement exponential backoff for rate limiting.
Cache results when possible to minimize API calls.

Support

If you encounter any issues or have questions, please contact our API support team at cloud-support@scrapehero.com or visit our API documentation at https://app.scrapehero.com/docs/api_intro.

Overview​

Authentication​

Endpoint​

Request Parameters​

Response Format​

Response Fields​

Usage Example​

Rate Limits​

Response Codes​

Best Practices​

Support​