Get Results
Retrieve scraped data from Realtor Listings Scraper
https://api.lobstr.io/v1/resultsRetrieve scraped data from your Realtor Listings Scraper runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
squidstringqueryrequiredHash of the squid to get results from.
runstringqueryHash of a specific run (optional).
pageintegerqueryPage number (default: 1).
page_sizeintegerqueryResults per page (default: 50, max: 100).
Result Fields
urlstringDirect URL to the listing on realtor.com. Example: https://www.realtor.com/realestateandhomes-detail/123-Main-St_Los-Angeles_CA_90001_M12345-67890
full_addressstringFull formatted address of the property. Example: 123 Main St, Los Angeles, CA 90001
streetstringStreet address. Example: 123 Main St
citystringCity name. Example: Los Angeles
statestringUS state abbreviation. Example: CA
countystringCounty name. Example: Los Angeles County
zip_codestringZIP code. Example: 90001
statusstringListing status (e.g. for_sale, sold, pending). Example: for_sale
priceintegerListed price in USD. Example: 750000
sold_priceintegerFinal sold price (if applicable). Example: 740000
currencystringCurrency of the price. Example: USD
bedintegerNumber of bedrooms. Example: 3
bathnumberNumber of bathrooms. Example: 2.5
house_sizeintegerInterior living area in square feet. Example: 1850
acre_lotnumberLot size in acres. Example: 0.15
property_typestringType of property (e.g. single_family, condo, townhouse). Example: single_family
is_new_constructionbooleanWhether the property is new construction. Example: false
is_to_be_builtbooleanWhether the property is to be built. Example: false
is_foreclosurebooleanWhether the listing is a foreclosure. Example: false
pendingbooleanWhether the listing is under contract/pending. Example: false
brokered_bystringName of the brokerage listing the property. Example: Keller Williams Realty
sellerstringPrimary seller or listing agent name.
co_sellerstringCo-seller or co-listing agent name.
latnumberLatitude coordinate of the property. Example: 34.052235
lngnumberLongitude coordinate of the property. Example: -118.243683
image_urlstringURL of the main listing photo.
published_atstringDate the listing was first published. Example: 2026-03-10
list_datestringDate the property was listed. Example: 2026-03-10
sold_datestringDate the property was sold (if applicable). Example: 2026-03-28
last_status_change_datedatetimeDate the listing status last changed (e.g. listed → pending). Example: 2026-04-02
year_builtintegerYear the property was built. Example: 1998
hoa_feeintegerMonthly HOA fee in USD. Example: 250
price_per_sqftintegerPrice per square foot. Example: 405
agent_namestringListing agent's display name. Example: Jane Smith
agent_phonestringListing agent's phone number. Example: +13105550142
agent_emailstringListing agent email address. Example: jane.smith@kw.com
office_namestringBrokerage office name. Example: Keller Williams Realty
office_phonestringBrokerage office phone number. Example: +13105550100
builder_namestringBuilder name for new-construction listings. Example: Pulte Homes
sub_typestringProperty sub-type (e.g. co_op, condo, townhouse). Example: townhouse
garageintegerNumber of garage spaces. Example: 2
neighborhoodstringNeighborhood name. Example: Silver Lake
neighborhoodsjsonAll neighborhood names for the listing (when multiple apply). Example: ["Silver Lake", "Eastside"]
county_fips_codestringCounty FIPS code, for joining to census or market data. Example: 06037
street_view_urlstringGoogle Street View image URL for the property.
virtual_tour_urlstringVirtual tour / 3D walkthrough URL.
is_price_reducedbooleanWhether the price was recently reduced. Example: false
is_contingentbooleanWhether the listing is contingent. Example: false
is_coming_soonbooleanWhether the listing is marked as coming soon. Example: false
is_new_listingbooleanWhether the listing was added in the last 14 days. Example: true
price_reduced_amountintegerAmount of the most recent price reduction in USD. Example: 25000
open_housesjsonScheduled open house dates and times, when available.
mls_idstringMLS listing ID. Example: SR26054321
property_idstringRealtor.com internal property ID. Example: M12345-67890
storiesintegerNumber of stories in the property. Example: 2
year_renovatedintegerYear the property was last renovated. Example: 2018
Detail Fields
These fields require property_details: true:
photosjsonFull photo gallery (list of image URLs). Requires property_details.
photo_countintegerTotal number of photos. Requires property_details. Example: 42
photo_tagsjsonPer-photo metadata: AI-generated room tags (e.g. kitchen, bedroom), title and description for each photo. Requires property_details.
description_textstringFull listing description text. Requires property_details.
property_historyjsonPrice and sale event timeline. Requires property_details.
tax_historyjsonYearly tax, assessment and market valuations. Requires property_details.
building_permits_historyjsonBuilding permit history with project, type of work, project type, and effective date. Requires property_details.
schoolsjsonRated nearby schools with grades, ratings and distance. Requires property_details.
spec_detailsjsonFull spec sheet grouped by category (interior, exterior, HOA, etc.). Requires property_details.
amenity_tagsjsonStructured amenity tags, each with a stable id and human-readable label. Requires property_details.
baths_fullintegerNumber of full bathrooms. Requires property_details. Example: 2
baths_halfintegerNumber of half bathrooms. Requires property_details. Example: 1
baths_3qtrintegerNumber of three-quarter bathrooms. Requires property_details. Example: 0
baths_totalintegerTotal bathroom count. Requires property_details. Example: 3
beds_maxintegerUpper bound of bedroom count for multi-unit listings. Requires property_details.
beds_minintegerLower bound of bedroom count for multi-unit listings. Requires property_details.
sqft_maxintegerUpper bound of square footage for multi-unit listings. Requires property_details.
sqft_minintegerLower bound of square footage for multi-unit listings. Requires property_details.
garage_typestringGarage type (e.g. attached, detached). Requires property_details.
coolingstringCooling system description. Requires property_details. Example: Central Air
heatingstringHeating system description. Requires property_details. Example: Forced Air
roofingstringRoofing material. Requires property_details. Example: Composition
exteriorstringExterior material. Requires property_details. Example: Stucco
constructionstringConstruction material. Requires property_details. Example: Wood Frame
stylesstringArchitectural style. Requires property_details. Example: Contemporary
poolstringPool features. Requires property_details. Example: In Ground
fireplacestringFireplace features. Requires property_details. Example: Gas
roomsstringTotal room count. Requires property_details. Example: 8
unitsstringNumber of units or unit type. Requires property_details.
zoningstringZoning designation. Requires property_details. Example: R1
fema_zonestringFEMA flood zone designation(s), comma-separated. Requires property_details. Example: X
noise_scoreintegerLocal noise score. Requires property_details. Example: 42
noise_categoriesjsonNoise source breakdown (e.g. traffic, airports). Requires property_details.
flood_factor_scoreintegerFlood Factor risk score 1–10. Requires property_details. Example: 2
flood_factor_severitystringFlood Factor severity label. Requires property_details. Example: Minimal
flood_trend_directionintegerDirection of change in flood risk over time. Requires property_details.
flood_trendstringShort summary of the flood risk trend. Requires property_details.
flood_trend_paragraphstringFull paragraph describing the flood risk trend. Requires property_details.
flood_insurance_textstringNarrative flood insurance guidance. Requires property_details.
flood_insurance_requirementstringWhether flood insurance is required or recommended. Requires property_details.
flood_firststreet_urlstringLink to the First Street flood risk report. Requires property_details.
flood_fsidstringFirst Street flood risk record ID. Requires property_details.
flood_insurance_ratesjsonFlood insurance quotes by provider. Requires property_details.
environmental_riskintegerEnvironmental flood risk score (similar scale to flood_factor_score). Requires property_details.
fire_factor_scoreintegerWildfire Factor risk score 1–10. Requires property_details. Example: 1
fire_factor_severitystringWildfire Factor severity label. Requires property_details. Example: Minor
fire_cumulative_30stringCumulative wildfire risk over the next 30 years. Requires property_details.
fire_trendstringShort summary of the wildfire risk trend. Requires property_details.
fire_trend_paragraphstringFull paragraph describing the wildfire risk trend. Requires property_details.
fire_insurance_textstringNarrative wildfire insurance guidance. Requires property_details.
usfs_relative_riskstringUS Forest Service relative wildfire risk narrative. Requires property_details.
fire_firststreet_urlstringLink to the First Street wildfire risk report. Requires property_details.
fire_fsidstringFirst Street wildfire risk record ID. Requires property_details.
fire_insurance_ratesjsonWildfire insurance quotes by provider. Requires property_details.
is_non_deededbooleanWhether ownership is non-deeded (e.g. co-op share). Requires property_details.
is_fractionally_ownedbooleanWhether the property is fractionally owned. Requires property_details.
is_price_excludes_landbooleanWhether the listed price excludes the land. Requires property_details.
is_usda_eligiblebooleanWhether the property is USDA loan eligible. Requires property_details.
is_short_salebooleanWhether the listing is a short sale. Requires property_details.
is_auctionbooleanWhether the listing is an auction. Requires property_details.
is_subdivisionbooleanWhether the property is part of a subdivision. Requires property_details.
street_numberstringParsed street number. Requires property_details. Example: 123
street_namestringParsed street name. Requires property_details. Example: Main
street_suffixstringParsed street suffix. Requires property_details. Example: St
street_directionstringParsed street direction prefix. Requires property_details. Example: N
unitstringParsed unit or apartment number. Requires property_details. Example: 4B
search_areasjsonBroader search areas (city/state/county) the listing belongs to. Requires property_details.
hot_market_badgestringLocal housing market heat badge for the postal code. Requires property_details. Example: Hot
state_licensestringListing agent's state real estate license number. Requires property_details.
agent_nrds_idstringAgent's NRDS ID — a stable identifier for deduping the same agent across listings. Requires property_details.
agent_idstringStable agent identifier. Requires property_details.
agent_hrefstringURL to the agent's Realtor.com profile. Requires property_details.
agent_sloganstringAgent's tagline or slogan. Requires property_details.
agent_mls_setstringAgent's MLS set identifier. Requires property_details.
agent_photo_urlstringAgent's profile photo URL. Requires property_details.
agent_addressjsonAgent's business address. Requires property_details.
agent_phonesjsonAll agent phone numbers, typed (mobile, office, etc.) and flagged primary. Requires property_details.
team_idstringStable team identifier when the agent belongs to a team. Requires property_details.
team_namestringTeam name when the agent belongs to a team. Requires property_details.
broker_namestringBroker (brokerage company) name. Requires property_details.
broker_idstringStable broker identifier. Requires property_details.
broker_logostringBroker logo image URL. Requires property_details.
broker_accent_colorstringBroker's brand accent color. Requires property_details.
broker_designationsjsonBroker designations or certifications. Requires property_details.
office_idstringStable brokerage office identifier. Requires property_details.
office_namestringBrokerage office name. Requires property_details.
office_emailstringBrokerage office contact email. Requires property_details.
office_hrefstringURL to the brokerage office's Realtor.com profile. Requires property_details.
office_sloganstringBrokerage office tagline or slogan. Requires property_details.
office_mls_setstringBrokerage office's MLS set identifier. Requires property_details.
office_application_urlstringOffice rental or application URL, when available. Requires property_details.
office_out_of_communitybooleanWhether the office is outside the listing's community. Requires property_details.
office_hoursjsonBrokerage office business hours. Requires property_details.
office_lead_emailstringOffice's direct lead-contact email. Requires property_details.
office_photo_urlstringBrokerage office photo or logo URL. Requires property_details.
office_addressjsonBrokerage office's full street address. Requires property_details.
office_phonesjsonAll brokerage office phone numbers, typed and flagged primary. Requires property_details.
Code Examples
curl -X GET "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=1&page_size=50" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "total_results": 120, "limit": 50, "page": 1, "total_pages": 3, "result_from": 1, "result_to": 50, "data": [ { "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4", "object": "result", "squid": "YOUR_SQUID_HASH", "run": "RUN_HASH", "url": "https://www.realtor.com/realestateandhomes-detail/123-Main-St_Los-Angeles_CA_90001_M12345-67890", "full_address": "123 Main St, Los Angeles, CA 90001", "street": "123 Main St", "city": "Los Angeles", "state": "CA", "county": "Los Angeles County", "zip_code": "90001", "status": "for_sale", "price": 750000, "sold_price": null, "currency": "USD", "bed": 3, "bath": 2.0, "house_size": 1850, "acre_lot": 0.15, "property_type": "single_family", "is_new_construction": false, "is_foreclosure": false, "pending": false, "brokered_by": "Keller Williams Realty", "lat": 34.052235, "lng": -118.243683, "published_at": "2026-03-10", "list_date": "2026-03-10", "scraping_time": "2026-03-20T09:15:00.000Z" }, { "id": "b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5", "object": "result", "squid": "YOUR_SQUID_HASH", "run": "RUN_HASH", "url": "https://www.realtor.com/realestateandhomes-detail/15-E-30th-St-Apt-44C_New-York_NY_10016_M90774-92123", "full_address": "15 E 30th St Apt 44C New York, NY 10016", "street": "15 E 30th St Apt 44C", "city": "New York", "state": "NY", "county": "New York", "zip_code": "10016", "status": "for_rent", "price": 12800, "sold_price": null, "currency": "USD", "bed": 1, "bath": 1.5, "house_size": 1100, "acre_lot": null, "property_type": "condos", "is_new_construction": null, "is_foreclosure": false, "pending": false, "brokered_by": "Keller Williams NYC", "lat": 40.745763, "lng": -73.984952, "published_at": "2026-04-28", "list_date": "2026-04-28", "scraping_time": "2026-04-28T17:33:27.629Z" } ], "next": "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=2&page_size=50", "previous": null }