Skip to main content
GET
/
v1
/
realtor
/
properties
/
{property_id}
Get Property Detail
curl --request GET \
  --url https://scrapebadger.com/v1/realtor/properties/{property_id} \
  --header 'x-api-key: <api-key>'
{
  "property_id": "<string>",
  "listing_id": "<string>",
  "mls_number": "<string>",
  "market": "<string>",
  "country": "<string>",
  "url": "<string>",
  "status": "<string>",
  "transaction_type": "<string>",
  "currency": "<string>",
  "list_price": 123,
  "list_price_formatted": "<string>",
  "list_price_min": 123,
  "list_price_max": 123,
  "price_per_sqft": 123,
  "price_reduced_amount": 123,
  "last_sold_price": 123,
  "last_sold_date_utc": 123,
  "last_sold_date_at": "<string>",
  "hoa_fee": 123,
  "property_type": "<string>",
  "sub_type": "<string>",
  "beds": 123,
  "baths": 123,
  "baths_full": 123,
  "baths_half": 123,
  "sqft": 123,
  "lot_sqft": 123,
  "year_built": 123,
  "stories": 123,
  "garage": 123,
  "rooms": 123,
  "parking_spaces": 123,
  "address": {
    "line": "<string>",
    "city": "<string>",
    "state": "<string>",
    "state_code": "<string>",
    "postal_code": "<string>",
    "country": "<string>",
    "neighborhood": "<string>",
    "county": "<string>",
    "coordinate": {
      "lat": 123,
      "lon": 123
    }
  },
  "description_text": "<string>",
  "primary_photo": "<string>",
  "photo_count": 123,
  "photos": [
    {
      "href": "<string>",
      "href_high": "<string>",
      "href_med": "<string>",
      "href_low": "<string>",
      "tags": [
        "<string>"
      ],
      "description": "<string>"
    }
  ],
  "virtual_tours": [
    "<string>"
  ],
  "videos": [
    "<string>"
  ],
  "flags": {
    "is_new_listing": true,
    "is_pending": true,
    "is_contingent": true,
    "is_foreclosure": true,
    "is_new_construction": true,
    "is_price_reduced": true,
    "is_coming_soon": true
  },
  "tags": [
    "<string>"
  ],
  "list_date_utc": 123,
  "list_date_at": "<string>",
  "last_update_utc": 123,
  "last_update_at": "<string>",
  "days_on_market": 123,
  "agents": [
    {
      "agent_id": "<string>",
      "name": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "title": "<string>",
      "type": "<string>",
      "email": "<string>",
      "phones": [
        {
          "number": "<string>",
          "type": "<string>",
          "ext": "<string>",
          "primary": true
        }
      ],
      "photo": "<string>",
      "href": "<string>",
      "office": {
        "name": "<string>",
        "email": "<string>",
        "href": "<string>",
        "logo": "<string>",
        "phones": [
          {
            "number": "<string>",
            "type": "<string>",
            "ext": "<string>",
            "primary": true
          }
        ],
        "address": {
          "line": "<string>",
          "city": "<string>",
          "state": "<string>",
          "state_code": "<string>",
          "postal_code": "<string>",
          "country": "<string>",
          "neighborhood": "<string>",
          "county": "<string>",
          "coordinate": {
            "lat": 123,
            "lon": 123
          }
        }
      },
      "broker": "<string>",
      "nrds_id": "<string>",
      "state_license": "<string>"
    }
  ],
  "source_mls_id": "<string>",
  "source_mls_name": "<string>",
  "open_houses": [
    {
      "start_utc": 123,
      "start_at": "<string>",
      "end_utc": 123,
      "end_at": "<string>",
      "description": "<string>",
      "time_zone": "<string>",
      "href": "<string>"
    }
  ],
  "details": [
    {
      "category": "<string>",
      "text": [
        "<string>"
      ]
    }
  ],
  "amenities": [
    "<string>"
  ],
  "tax_history": [
    {
      "year": 123,
      "tax": 123,
      "assessment_building": 123,
      "assessment_land": 123,
      "assessment_total": 123
    }
  ],
  "price_history": [
    {
      "date_utc": 123,
      "date_at": "<string>",
      "event": "<string>",
      "price": 123,
      "price_per_sqft": 123,
      "source_listing_id": "<string>"
    }
  ],
  "schools": [
    {
      "name": "<string>",
      "rating": 123,
      "education_levels": [
        "<string>"
      ],
      "grades": "<string>",
      "distance_miles": 123,
      "district": "<string>"
    }
  ],
  "estimates": [
    {
      "source": "<string>",
      "estimate": 123,
      "estimate_high": 123,
      "estimate_low": 123,
      "date_utc": 123,
      "date_at": "<string>"
    }
  ]
}

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

{
  "property_id": "1234567890",
  "listing_id": "2960000001",
  "mls_number": "ACT1234567",
  "market": "us",
  "country": "US",
  "url": "https://www.realtor.com/realestateandhomes-detail/1234567890",
  "status": "for_sale",
  "currency": "USD",
  "list_price": 450000,
  "list_price_formatted": "$450,000",
  "price_per_sqft": 250,
  "hoa_fee": 45,
  "property_type": "single_family",
  "beds": 3,
  "baths": 2,
  "sqft": 1800,
  "lot_sqft": 6500,
  "year_built": 2015,
  "address": {
    "line": "123 Main St",
    "city": "Austin",
    "state": "Texas",
    "state_code": "TX",
    "postal_code": "78701",
    "country": "US",
    "neighborhood": "Downtown",
    "county": "Travis",
    "coordinate": { "lat": 30.2672, "lon": -97.7431 }
  },
  "primary_photo": "https://ap.rdcpix.com/abc/s.jpg",
  "photo_count": 32,
  "days_on_market": 4,
  "agents": [
    {
      "agent_id": "A1",
      "name": "Jane Doe",
      "email": "jane@realty.com",
      "phones": [{ "number": "512-555-0100", "type": "mobile", "primary": true }],
      "office": { "name": "Downtown Realty", "href": "https://www.realtor.com/realestateagency/..." },
      "broker": "Downtown Realty Group"
    }
  ],
  "details": [
    { "category": "Interior Features", "text": ["Hardwood floors", "Granite countertops"] }
  ],
  "amenities": ["Pool", "Garage"],
  "tax_history": [
    { "year": 2024, "tax": 6200, "assessment_building": 300000, "assessment_land": 120000, "assessment_total": 420000 }
  ],
  "price_history": [
    { "date_at": "2026-06-01T00:00:00Z", "event": "Listed", "price": 450000, "price_per_sqft": 250 }
  ],
  "schools": [
    { "name": "Austin Elementary", "rating": 8, "education_levels": ["elementary"], "grades": "K-5", "distance_miles": 0.4, "district": "Austin ISD" }
  ],
  "estimates": [
    { "source": "realtor", "estimate": 455000, "estimate_high": 475000, "estimate_low": 435000, "date_at": "2026-06-20T00:00:00Z" }
  ]
}
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[]