> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Property Detail
> Full detail for a single property — price/tax history, schools, amenities, agents, and estimates.
## Path Parameters
The portal property id. You can find this in search results or extract it from a listing URL.
## Query Parameters
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.
Portal property id.
Portal listing id (nullable).
MLS number (nullable).
Market (`us` or `ca`).
ISO country code.
Full URL to the listing.
Listing status (`for_sale`, `for_rent`, `sold`, `pending`).
ISO 4217 currency code.
List price (nullable).
Human-formatted price (nullable).
Price per square foot (nullable).
Monthly HOA fee (nullable).
Property type (nullable).
Bedrooms (nullable).
Bathrooms (nullable).
Interior square footage (nullable).
Lot square footage (nullable).
Year built (nullable).
Address with `line`, `city`, `state`, `state_code`, `postal_code`, `country`, `neighborhood`, `county`, and `coordinate` (`{lat, lon}`).
Listing description (nullable).
Primary photo URL (nullable).
Total number of photos.
Photo objects with `href`, `href_high`, `href_med`, `href_low`, `tags[]`, `description`.
Virtual tour URLs.
Video URLs.
Boolean flags: `is_new_listing`, `is_pending`, `is_contingent`, `is_foreclosure`, `is_new_construction`, `is_price_reduced`, `is_coming_soon`.
Days on market (nullable).
Listing agents.
Agent id.
Full name.
First name (nullable).
Last name (nullable).
Title (nullable).
Agent type, e.g. `seller`, `buyer` (nullable).
Email (nullable).
Phone objects with `number`, `type`, `ext`, `primary`.
Agent photo URL (nullable).
Agent profile URL (nullable).
Office with `name`, `email`, `href`, `logo`, `phones[]`, `address`.
Brokerage name (nullable).
NRDS id (nullable).
State license number (nullable).
Open house objects with `start_utc`, `start_at`, `end_utc`, `end_at`, `description`, `time_zone`, `href`.
Grouped listing details.
Detail category, e.g. `Interior Features`.
List of detail strings in the category.
List of amenity strings.
Yearly tax records.
Tax year.
Tax amount (nullable).
Building assessment (nullable).
Land assessment (nullable).
Total assessment (nullable).
Price / listing events over time.
Event date as a Unix timestamp (nullable).
Event date as an ISO-8601 string (nullable).
Event type, e.g. `Listed`, `Sold`, `Price Changed`.
Price at the event (nullable).
Price per sqft at the event (nullable).
Source listing id (nullable).
Nearby schools.
School name.
School rating (nullable).
Education levels served, e.g. `["elementary"]`.
Grade range, e.g. `K-5` (nullable).
Distance from the property in miles (nullable).
School district (nullable).
Value estimates.
Estimate source.
Point estimate (nullable).
High estimate (nullable).
Low estimate (nullable).
Estimate date as a Unix timestamp (nullable).
Estimate date as an ISO-8601 string (nullable).
### Example Response
```json theme={null}
{
"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.
## OpenAPI
````yaml GET /v1/realtor/properties/{property_id}
openapi: 3.1.0
info:
title: ScrapeBadger Realtor API
version: 1.0.0
description: >-
Unified real-estate scraping API over realtor.com (US) and realtor.ca
(Canada) for searching listings, fetching full property detail (price/tax
history, schools, agents, estimates), location autocomplete, and reference
data.
servers:
- url: https://scrapebadger.com
description: Production
security:
- apiKeyAuth: []
paths:
/v1/realtor/properties/{property_id}:
get:
tags:
- Realtor Properties
summary: Get Property Detail
description: >-
Get a single property's full detail (price/tax history, schools,
amenities, agents, estimates).
operationId: getRealtorProperty
parameters:
- name: property_id
in: path
required: true
schema:
type: string
description: The portal property id.
- name: market
in: query
schema:
type: string
default: us
enum:
- us
- ca
description: 'Market the property lives in: us (realtor.com) or ca (realtor.ca).'
responses:
'200':
description: Property detail
content:
application/json:
schema:
$ref: '#/components/schemas/PropertyDetail'
components:
schemas:
PropertyDetail:
allOf:
- $ref: '#/components/schemas/Property'
- type: object
properties:
details:
type: array
items:
type: object
properties:
category:
type:
- string
- 'null'
text:
type: array
items:
type: string
amenities:
type: array
items:
type: string
tax_history:
type: array
items:
type: object
properties:
year:
type:
- integer
- 'null'
tax:
type:
- number
- 'null'
assessment_building:
type:
- number
- 'null'
assessment_land:
type:
- number
- 'null'
assessment_total:
type:
- number
- 'null'
price_history:
type: array
items:
type: object
properties:
date_utc:
type:
- number
- 'null'
date_at:
type:
- string
- 'null'
event:
type:
- string
- 'null'
price:
type:
- number
- 'null'
price_per_sqft:
type:
- number
- 'null'
source_listing_id:
type:
- string
- 'null'
schools:
type: array
items:
type: object
properties:
name:
type:
- string
- 'null'
rating:
type:
- number
- 'null'
education_levels:
type: array
items:
type: string
grades:
type:
- string
- 'null'
distance_miles:
type:
- number
- 'null'
district:
type:
- string
- 'null'
estimates:
type: array
items:
type: object
properties:
source:
type:
- string
- 'null'
estimate:
type:
- number
- 'null'
estimate_high:
type:
- number
- 'null'
estimate_low:
type:
- number
- 'null'
date_utc:
type:
- number
- 'null'
date_at:
type:
- string
- 'null'
Property:
type: object
properties:
property_id:
type: string
listing_id:
type:
- string
- 'null'
mls_number:
type:
- string
- 'null'
market:
type: string
country:
type:
- string
- 'null'
url:
type:
- string
- 'null'
status:
type:
- string
- 'null'
transaction_type:
type:
- string
- 'null'
currency:
type:
- string
- 'null'
list_price:
type:
- number
- 'null'
list_price_formatted:
type:
- string
- 'null'
list_price_min:
type:
- number
- 'null'
list_price_max:
type:
- number
- 'null'
price_per_sqft:
type:
- number
- 'null'
price_reduced_amount:
type:
- number
- 'null'
last_sold_price:
type:
- number
- 'null'
last_sold_date_utc:
type:
- number
- 'null'
last_sold_date_at:
type:
- string
- 'null'
hoa_fee:
type:
- number
- 'null'
property_type:
type:
- string
- 'null'
sub_type:
type:
- string
- 'null'
beds:
type:
- integer
- 'null'
baths:
type:
- number
- 'null'
baths_full:
type:
- integer
- 'null'
baths_half:
type:
- integer
- 'null'
sqft:
type:
- integer
- 'null'
lot_sqft:
type:
- integer
- 'null'
year_built:
type:
- integer
- 'null'
stories:
type:
- integer
- 'null'
garage:
type:
- integer
- 'null'
rooms:
type:
- integer
- 'null'
parking_spaces:
type:
- integer
- 'null'
address:
$ref: '#/components/schemas/Address'
description_text:
type:
- string
- 'null'
primary_photo:
type:
- string
- 'null'
photo_count:
type:
- integer
- 'null'
photos:
type: array
items:
$ref: '#/components/schemas/Photo'
virtual_tours:
type: array
items:
type: string
videos:
type: array
items:
type: string
flags:
$ref: '#/components/schemas/Flags'
tags:
type: array
items:
type: string
list_date_utc:
type:
- number
- 'null'
list_date_at:
type:
- string
- 'null'
last_update_utc:
type:
- number
- 'null'
last_update_at:
type:
- string
- 'null'
days_on_market:
type:
- integer
- 'null'
agents:
type: array
items:
$ref: '#/components/schemas/Agent'
source_mls_id:
type:
- string
- 'null'
source_mls_name:
type:
- string
- 'null'
open_houses:
type: array
items:
$ref: '#/components/schemas/OpenHouse'
Address:
type: object
properties:
line:
type:
- string
- 'null'
city:
type:
- string
- 'null'
state:
type:
- string
- 'null'
state_code:
type:
- string
- 'null'
postal_code:
type:
- string
- 'null'
country:
type:
- string
- 'null'
neighborhood:
type:
- string
- 'null'
county:
type:
- string
- 'null'
coordinate:
$ref: '#/components/schemas/Coordinate'
Photo:
type: object
properties:
href:
type:
- string
- 'null'
href_high:
type:
- string
- 'null'
href_med:
type:
- string
- 'null'
href_low:
type:
- string
- 'null'
tags:
type: array
items:
type: string
description:
type:
- string
- 'null'
Flags:
type: object
properties:
is_new_listing:
type:
- boolean
- 'null'
is_pending:
type:
- boolean
- 'null'
is_contingent:
type:
- boolean
- 'null'
is_foreclosure:
type:
- boolean
- 'null'
is_new_construction:
type:
- boolean
- 'null'
is_price_reduced:
type:
- boolean
- 'null'
is_coming_soon:
type:
- boolean
- 'null'
Agent:
type: object
properties:
agent_id:
type:
- string
- 'null'
name:
type:
- string
- 'null'
first_name:
type:
- string
- 'null'
last_name:
type:
- string
- 'null'
title:
type:
- string
- 'null'
type:
type:
- string
- 'null'
email:
type:
- string
- 'null'
phones:
type: array
items:
$ref: '#/components/schemas/Phone'
photo:
type:
- string
- 'null'
href:
type:
- string
- 'null'
office:
$ref: '#/components/schemas/Office'
broker:
type:
- string
- 'null'
nrds_id:
type:
- string
- 'null'
state_license:
type:
- string
- 'null'
OpenHouse:
type: object
properties:
start_utc:
type:
- number
- 'null'
start_at:
type:
- string
- 'null'
end_utc:
type:
- number
- 'null'
end_at:
type:
- string
- 'null'
description:
type:
- string
- 'null'
time_zone:
type:
- string
- 'null'
href:
type:
- string
- 'null'
Coordinate:
type: object
properties:
lat:
type:
- number
- 'null'
lon:
type:
- number
- 'null'
Phone:
type: object
properties:
number:
type:
- string
- 'null'
type:
type:
- string
- 'null'
ext:
type:
- string
- 'null'
primary:
type:
- boolean
- 'null'
Office:
type: object
properties:
name:
type:
- string
- 'null'
email:
type:
- string
- 'null'
href:
type:
- string
- 'null'
logo:
type:
- string
- 'null'
phones:
type: array
items:
$ref: '#/components/schemas/Phone'
address:
$ref: '#/components/schemas/Address'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
````