Skip to main content
GET
Get Property Detail

Path Parameters

property_id
string
required
The portal property id. You can find this in search results or extract it from a listing URL.

Query Parameters

market
string
default:"us"
Which market the property lives in: us (realtor.com) or ca (realtor.ca).

Response

The response is a PropertyDetail object returned at the top level (no wrapper). It contains every field of a search-result Property plus the detail-only fields below.
property_id
string
Portal property id.
listing_id
string
Portal listing id (nullable).
mls_number
string
MLS number (nullable).
market
string
Market (us or ca).
country
string
ISO country code.
url
string
Full URL to the listing.
status
string
Listing status (for_sale, for_rent, sold, pending).
currency
string
ISO 4217 currency code.
list_price
number
List price (nullable).
list_price_formatted
string
Human-formatted price (nullable).
price_per_sqft
number
Price per square foot (nullable).
hoa_fee
number
Monthly HOA fee (nullable).
property_type
string
Property type (nullable).
beds
integer
Bedrooms (nullable).
baths
number
Bathrooms (nullable).
sqft
integer
Interior square footage (nullable).
lot_sqft
integer
Lot square footage (nullable).
year_built
integer
Year built (nullable).
address
object
Address with line, city, state, state_code, postal_code, country, neighborhood, county, and coordinate ({lat, lon}).
description_text
string
Listing description (nullable).
primary_photo
string
Primary photo URL (nullable).
photo_count
integer
Total number of photos.
photos
array
Photo objects with href, href_high, href_med, href_low, tags[], description.
virtual_tours
array
Virtual tour URLs.
videos
array
Video URLs.
flags
object
Boolean flags: is_new_listing, is_pending, is_contingent, is_foreclosure, is_new_construction, is_price_reduced, is_coming_soon.
days_on_market
integer
Days on market (nullable).
agents
array
Listing agents.
open_houses
array
Open house objects with start_utc, start_at, end_utc, end_at, description, time_zone, href.
details
array
Grouped listing details.
amenities
array
List of amenity strings.
tax_history
array
Yearly tax records.
price_history
array
Price / listing events over time.
schools
array
Nearby schools.
estimates
array
Value estimates.

Example Response

Each property-detail request costs 10 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Path Parameters

property_id
string
required

The portal property id.

Query Parameters

market
enum<string>
default:us

Market the property lives in: us (realtor.com) or ca (realtor.ca).

Available options:
us,
ca

Response

200 - application/json

Property detail

property_id
string
listing_id
string | null
mls_number
string | null
market
string
country
string | null
url
string | null
status
string | null
transaction_type
string | null
currency
string | null
list_price
number | null
list_price_formatted
string | null
list_price_min
number | null
list_price_max
number | null
price_per_sqft
number | null
price_reduced_amount
number | null
last_sold_price
number | null
last_sold_date_utc
number | null
last_sold_date_at
string | null
hoa_fee
number | null
property_type
string | null
sub_type
string | null
beds
integer | null
baths
number | null
baths_full
integer | null
baths_half
integer | null
sqft
integer | null
lot_sqft
integer | null
year_built
integer | null
stories
integer | null
garage
integer | null
rooms
integer | null
parking_spaces
integer | null
address
object
description_text
string | null
primary_photo
string | null
photo_count
integer | null
photos
object[]
virtual_tours
string[]
videos
string[]
flags
object
tags
string[]
list_date_utc
number | null
list_date_at
string | null
last_update_utc
number | null
last_update_at
string | null
days_on_market
integer | null
agents
object[]
source_mls_id
string | null
source_mls_name
string | null
open_houses
object[]
details
object[]
amenities
string[]
tax_history
object[]
price_history
object[]
schools
object[]
estimates
object[]