Skip to main content
GET
Get Results
Retrieve scraped data from your Realtor Listings Scraper runs.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

string
required
Hash of the squid to get results from.
string
Hash of a specific run (optional).
integer
Page number (default: 1).
integer
Results per page (default: 50, max: 100).

Result Fields

string
Direct URL to the listing on realtor.com. Example: https://www.realtor.com/realestateandhomes-detail/123-Main-St_Los-Angeles_CA_90001_M12345-67890
string
Full formatted address of the property. Example: 123 Main St, Los Angeles, CA 90001
string
Street address. Example: 123 Main St
string
City name. Example: Los Angeles
string
US state abbreviation. Example: CA
string
County name. Example: Los Angeles County
string
ZIP code. Example: 90001
string
Listing status (e.g. for_sale, sold, pending). Example: for_sale
integer
Listed price in USD. Example: 750000
integer
Final sold price (if applicable). Example: 740000
string
Currency of the price. Example: USD
integer
Number of bedrooms. Example: 3
number
Number of bathrooms. Example: 2.5
integer
Interior living area in square feet. Example: 1850
number
Lot size in acres. Example: 0.15
string
Type of property (e.g. single_family, condo, townhouse). Example: single_family
boolean
Whether the property is new construction. Example: false
boolean
Whether the property is to be built. Example: false
boolean
Whether the listing is a foreclosure. Example: false
boolean
Whether the listing is under contract/pending. Example: false
string
Name of the brokerage listing the property. Example: Keller Williams Realty
string
Primary seller or listing agent name.
string
Co-seller or co-listing agent name.
number
Latitude coordinate of the property. Example: 34.052235
number
Longitude coordinate of the property. Example: -118.243683
string
URL of the main listing photo.
string
Date the listing was first published. Example: 2026-03-10
string
Date the property was listed. Example: 2026-03-10
string
Date the property was sold (if applicable). Example: 2026-03-28
datetime
Date the listing status last changed (e.g. listed → pending). Example: 2026-04-02
integer
Year the property was built. Example: 1998
integer
Monthly HOA fee in USD. Example: 250
integer
Price per square foot. Example: 405
string
Listing agent’s display name. Example: Jane Smith
string
Listing agent’s phone number. Example: +13105550142
string
Listing agent email address. Example: jane.smith@kw.com
string
Brokerage office name. Example: Keller Williams Realty
string
Brokerage office phone number. Example: +13105550100
string
Builder name for new-construction listings. Example: Pulte Homes
string
Property sub-type (e.g. co_op, condo, townhouse). Example: townhouse
integer
Number of garage spaces. Example: 2
string
Neighborhood name. Example: Silver Lake
json
All neighborhood names for the listing (when multiple apply). Example: ["Silver Lake", "Eastside"]
string
County FIPS code, for joining to census or market data. Example: 06037
string
Google Street View image URL for the property.
string
Virtual tour / 3D walkthrough URL.
boolean
Whether the price was recently reduced. Example: false
boolean
Whether the listing is contingent. Example: false
boolean
Whether the listing is marked as coming soon. Example: false
boolean
Whether the listing was added in the last 14 days. Example: true
integer
Amount of the most recent price reduction in USD. Example: 25000
json
Scheduled open house dates and times, when available.
string
MLS listing ID. Example: SR26054321
string
Realtor.com internal property ID. Example: M12345-67890
integer
Number of stories in the property. Example: 2
integer
Year the property was last renovated. Example: 2018

Detail Fields

These fields require property_details: true:
json
Full photo gallery (list of image URLs). Requires property_details.
integer
Total number of photos. Requires property_details. Example: 42
json
Per-photo metadata: AI-generated room tags (e.g. kitchen, bedroom), title and description for each photo. Requires property_details.
string
Full listing description text. Requires property_details.
json
Price and sale event timeline. Requires property_details.
json
Yearly tax, assessment and market valuations. Requires property_details.
json
Building permit history with project, type of work, project type, and effective date. Requires property_details.
json
Rated nearby schools with grades, ratings and distance. Requires property_details.
json
Full spec sheet grouped by category (interior, exterior, HOA, etc.). Requires property_details.
json
Structured amenity tags, each with a stable id and human-readable label. Requires property_details.
integer
Number of full bathrooms. Requires property_details. Example: 2
integer
Number of half bathrooms. Requires property_details. Example: 1
integer
Number of three-quarter bathrooms. Requires property_details. Example: 0
integer
Total bathroom count. Requires property_details. Example: 3
integer
Upper bound of bedroom count for multi-unit listings. Requires property_details.
integer
Lower bound of bedroom count for multi-unit listings. Requires property_details.
integer
Upper bound of square footage for multi-unit listings. Requires property_details.
integer
Lower bound of square footage for multi-unit listings. Requires property_details.
string
Garage type (e.g. attached, detached). Requires property_details.
string
Cooling system description. Requires property_details. Example: Central Air
string
Heating system description. Requires property_details. Example: Forced Air
string
Roofing material. Requires property_details. Example: Composition
string
Exterior material. Requires property_details. Example: Stucco
string
Construction material. Requires property_details. Example: Wood Frame
string
Architectural style. Requires property_details. Example: Contemporary
string
Pool features. Requires property_details. Example: In Ground
string
Fireplace features. Requires property_details. Example: Gas
string
Total room count. Requires property_details. Example: 8
string
Number of units or unit type. Requires property_details.
string
Zoning designation. Requires property_details. Example: R1
string
FEMA flood zone designation(s), comma-separated. Requires property_details. Example: X
integer
Local noise score. Requires property_details. Example: 42
json
Noise source breakdown (e.g. traffic, airports). Requires property_details.
integer
Flood Factor risk score 1–10. Requires property_details. Example: 2
string
Flood Factor severity label. Requires property_details. Example: Minimal
integer
Direction of change in flood risk over time. Requires property_details.
string
Short summary of the flood risk trend. Requires property_details.
string
Full paragraph describing the flood risk trend. Requires property_details.
string
Narrative flood insurance guidance. Requires property_details.
string
Whether flood insurance is required or recommended. Requires property_details.
string
Link to the First Street flood risk report. Requires property_details.
string
First Street flood risk record ID. Requires property_details.
json
Flood insurance quotes by provider. Requires property_details.
integer
Environmental flood risk score (similar scale to flood_factor_score). Requires property_details.
integer
Wildfire Factor risk score 1–10. Requires property_details. Example: 1
string
Wildfire Factor severity label. Requires property_details. Example: Minor
string
Cumulative wildfire risk over the next 30 years. Requires property_details.
string
Short summary of the wildfire risk trend. Requires property_details.
string
Full paragraph describing the wildfire risk trend. Requires property_details.
string
Narrative wildfire insurance guidance. Requires property_details.
string
US Forest Service relative wildfire risk narrative. Requires property_details.
string
Link to the First Street wildfire risk report. Requires property_details.
string
First Street wildfire risk record ID. Requires property_details.
json
Wildfire insurance quotes by provider. Requires property_details.
boolean
Whether ownership is non-deeded (e.g. co-op share). Requires property_details.
boolean
Whether the property is fractionally owned. Requires property_details.
boolean
Whether the listed price excludes the land. Requires property_details.
boolean
Whether the property is USDA loan eligible. Requires property_details.
boolean
Whether the listing is a short sale. Requires property_details.
boolean
Whether the listing is an auction. Requires property_details.
boolean
Whether the property is part of a subdivision. Requires property_details.
string
Parsed street number. Requires property_details. Example: 123
string
Parsed street name. Requires property_details. Example: Main
string
Parsed street suffix. Requires property_details. Example: St
string
Parsed street direction prefix. Requires property_details. Example: N
string
Parsed unit or apartment number. Requires property_details. Example: 4B
json
Broader search areas (city/state/county) the listing belongs to. Requires property_details.
string
Local housing market heat badge for the postal code. Requires property_details. Example: Hot
string
Listing agent’s state real estate license number. Requires property_details.
string
Agent’s NRDS ID — a stable identifier for deduping the same agent across listings. Requires property_details.
string
Stable agent identifier. Requires property_details.
string
URL to the agent’s Realtor.com profile. Requires property_details.
string
Agent’s tagline or slogan. Requires property_details.
string
Agent’s MLS set identifier. Requires property_details.
string
Agent’s profile photo URL. Requires property_details.
json
Agent’s business address. Requires property_details.
json
All agent phone numbers, typed (mobile, office, etc.) and flagged primary. Requires property_details.
string
Stable team identifier when the agent belongs to a team. Requires property_details.
string
Team name when the agent belongs to a team. Requires property_details.
string
Broker (brokerage company) name. Requires property_details.
string
Stable broker identifier. Requires property_details.
Broker logo image URL. Requires property_details.
string
Broker’s brand accent color. Requires property_details.
json
Broker designations or certifications. Requires property_details.
string
Stable brokerage office identifier. Requires property_details.
string
Brokerage office name. Requires property_details.
string
Brokerage office contact email. Requires property_details.
string
URL to the brokerage office’s Realtor.com profile. Requires property_details.
string
Brokerage office tagline or slogan. Requires property_details.
string
Brokerage office’s MLS set identifier. Requires property_details.
string
Office rental or application URL, when available. Requires property_details.
boolean
Whether the office is outside the listing’s community. Requires property_details.
json
Brokerage office business hours. Requires property_details.
string
Office’s direct lead-contact email. Requires property_details.
string
Brokerage office photo or logo URL. Requires property_details.
json
Brokerage office’s full street address. Requires property_details.
json
All brokerage office phone numbers, typed and flagged primary. Requires property_details.

Code Examples

Response

200