> ## Documentation Index > Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt > Use this file to discover all available pages before exploring further. # Get Results > Retrieve scraped data from Realtor Listings Scraper Retrieve scraped data from your **Realtor Listings Scraper** runs. ## Headers Your API authentication token. Value: `Token YOUR_API_KEY` ## Query Parameters Hash of the squid to get results from. Hash of a specific run (optional). Page number (default: 1). Results per page (default: 50, max: 100). ## Result Fields Direct URL to the listing on realtor.com. Example: `https://www.realtor.com/realestateandhomes-detail/123-Main-St_Los-Angeles_CA_90001_M12345-67890` Full formatted address of the property. Example: `123 Main St, Los Angeles, CA 90001` Street address. Example: `123 Main St` City name. Example: `Los Angeles` US state abbreviation. Example: `CA` County name. Example: `Los Angeles County` ZIP code. Example: `90001` Listing status (e.g. for\_sale, sold, pending). Example: `for_sale` Listed price in USD. Example: `750000` Final sold price (if applicable). Example: `740000` Currency of the price. Example: `USD` Number of bedrooms. Example: `3` Number of bathrooms. Example: `2.5` Interior living area in square feet. Example: `1850` Lot size in acres. Example: `0.15` Type of property (e.g. single\_family, condo, townhouse). Example: `single_family` Whether the property is new construction. Example: `false` Whether the property is to be built. Example: `false` Whether the listing is a foreclosure. Example: `false` Whether the listing is under contract/pending. Example: `false` Name of the brokerage listing the property. Example: `Keller Williams Realty` Primary seller or listing agent name. Co-seller or co-listing agent name. Latitude coordinate of the property. Example: `34.052235` Longitude coordinate of the property. Example: `-118.243683` URL of the main listing photo. Date the listing was first published. Example: `2026-03-10` Date the property was listed. Example: `2026-03-10` Date the property was sold (if applicable). Example: `2026-03-28` Date the listing status last changed (e.g. listed → pending). Example: `2026-04-02` Year the property was built. Example: `1998` Monthly HOA fee in USD. Example: `250` Price per square foot. Example: `405` Listing agent's display name. Example: `Jane Smith` Listing agent's phone number. Example: `+13105550142` Listing agent email address. Example: `jane.smith@kw.com` Brokerage office name. Example: `Keller Williams Realty` Brokerage office phone number. Example: `+13105550100` Builder name for new-construction listings. Example: `Pulte Homes` Property sub-type (e.g. `co_op`, `condo`, `townhouse`). Example: `townhouse` Number of garage spaces. Example: `2` Neighborhood name. Example: `Silver Lake` All neighborhood names for the listing (when multiple apply). Example: `["Silver Lake", "Eastside"]` County FIPS code, for joining to census or market data. Example: `06037` Google Street View image URL for the property. Virtual tour / 3D walkthrough URL. Whether the price was recently reduced. Example: `false` Whether the listing is contingent. Example: `false` Whether the listing is marked as coming soon. Example: `false` Whether the listing was added in the last 14 days. Example: `true` Amount of the most recent price reduction in USD. Example: `25000` Scheduled open house dates and times, when available. MLS listing ID. Example: `SR26054321` Realtor.com internal property ID. Example: `M12345-67890` Number of stories in the property. Example: `2` Year the property was last renovated. Example: `2018` ## Detail Fields These fields require `property_details: true`: Full photo gallery (list of image URLs). Requires `property_details`. Total number of photos. Requires `property_details`. Example: `42` Per-photo metadata: AI-generated room tags (e.g. kitchen, bedroom), title and description for each photo. Requires `property_details`. Full listing description text. Requires `property_details`. Price and sale event timeline. Requires `property_details`. Yearly tax, assessment and market valuations. Requires `property_details`. Building permit history with project, type of work, project type, and effective date. Requires `property_details`. Rated nearby schools with grades, ratings and distance. Requires `property_details`. Full spec sheet grouped by category (interior, exterior, HOA, etc.). Requires `property_details`. Structured amenity tags, each with a stable `id` and human-readable `label`. Requires `property_details`. Number of full bathrooms. Requires `property_details`. Example: `2` Number of half bathrooms. Requires `property_details`. Example: `1` Number of three-quarter bathrooms. Requires `property_details`. Example: `0` Total bathroom count. Requires `property_details`. Example: `3` Upper bound of bedroom count for multi-unit listings. Requires `property_details`. Lower bound of bedroom count for multi-unit listings. Requires `property_details`. Upper bound of square footage for multi-unit listings. Requires `property_details`. Lower bound of square footage for multi-unit listings. Requires `property_details`. Garage type (e.g. `attached`, `detached`). Requires `property_details`. Cooling system description. Requires `property_details`. Example: `Central Air` Heating system description. Requires `property_details`. Example: `Forced Air` Roofing material. Requires `property_details`. Example: `Composition` Exterior material. Requires `property_details`. Example: `Stucco` Construction material. Requires `property_details`. Example: `Wood Frame` Architectural style. Requires `property_details`. Example: `Contemporary` Pool features. Requires `property_details`. Example: `In Ground` Fireplace features. Requires `property_details`. Example: `Gas` Total room count. Requires `property_details`. Example: `8` Number of units or unit type. Requires `property_details`. Zoning designation. Requires `property_details`. Example: `R1` FEMA flood zone designation(s), comma-separated. Requires `property_details`. Example: `X` Local noise score. Requires `property_details`. Example: `42` Noise source breakdown (e.g. traffic, airports). Requires `property_details`. Flood Factor risk score 1–10. Requires `property_details`. Example: `2` Flood Factor severity label. Requires `property_details`. Example: `Minimal` Direction of change in flood risk over time. Requires `property_details`. Short summary of the flood risk trend. Requires `property_details`. Full paragraph describing the flood risk trend. Requires `property_details`. Narrative flood insurance guidance. Requires `property_details`. Whether flood insurance is required or recommended. Requires `property_details`. Link to the First Street flood risk report. Requires `property_details`. First Street flood risk record ID. Requires `property_details`. Flood insurance quotes by provider. Requires `property_details`. Environmental flood risk score (similar scale to flood\_factor\_score). Requires `property_details`. Wildfire Factor risk score 1–10. Requires `property_details`. Example: `1` Wildfire Factor severity label. Requires `property_details`. Example: `Minor` Cumulative wildfire risk over the next 30 years. Requires `property_details`. Short summary of the wildfire risk trend. Requires `property_details`. Full paragraph describing the wildfire risk trend. Requires `property_details`. Narrative wildfire insurance guidance. Requires `property_details`. US Forest Service relative wildfire risk narrative. Requires `property_details`. Link to the First Street wildfire risk report. Requires `property_details`. First Street wildfire risk record ID. Requires `property_details`. Wildfire insurance quotes by provider. Requires `property_details`. Whether ownership is non-deeded (e.g. co-op share). Requires `property_details`. Whether the property is fractionally owned. Requires `property_details`. Whether the listed price excludes the land. Requires `property_details`. Whether the property is USDA loan eligible. Requires `property_details`. Whether the listing is a short sale. Requires `property_details`. Whether the listing is an auction. Requires `property_details`. Whether the property is part of a subdivision. Requires `property_details`. Parsed street number. Requires `property_details`. Example: `123` Parsed street name. Requires `property_details`. Example: `Main` Parsed street suffix. Requires `property_details`. Example: `St` Parsed street direction prefix. Requires `property_details`. Example: `N` Parsed unit or apartment number. Requires `property_details`. Example: `4B` Broader search areas (city/state/county) the listing belongs to. Requires `property_details`. Local housing market heat badge for the postal code. Requires `property_details`. Example: `Hot` Listing agent's state real estate license number. Requires `property_details`. Agent's NRDS ID — a stable identifier for deduping the same agent across listings. Requires `property_details`. Stable agent identifier. Requires `property_details`. URL to the agent's Realtor.com profile. Requires `property_details`. Agent's tagline or slogan. Requires `property_details`. Agent's MLS set identifier. Requires `property_details`. Agent's profile photo URL. Requires `property_details`. Agent's business address. Requires `property_details`. All agent phone numbers, typed (mobile, office, etc.) and flagged primary. Requires `property_details`. Stable team identifier when the agent belongs to a team. Requires `property_details`. Team name when the agent belongs to a team. Requires `property_details`. Broker (brokerage company) name. Requires `property_details`. Stable broker identifier. Requires `property_details`. Broker logo image URL. Requires `property_details`. Broker's brand accent color. Requires `property_details`. Broker designations or certifications. Requires `property_details`. Stable brokerage office identifier. Requires `property_details`. Brokerage office name. Requires `property_details`. Brokerage office contact email. Requires `property_details`. URL to the brokerage office's Realtor.com profile. Requires `property_details`. Brokerage office tagline or slogan. Requires `property_details`. Brokerage office's MLS set identifier. Requires `property_details`. Office rental or application URL, when available. Requires `property_details`. Whether the office is outside the listing's community. Requires `property_details`. Brokerage office business hours. Requires `property_details`. Office's direct lead-contact email. Requires `property_details`. Brokerage office photo or logo URL. Requires `property_details`. Brokerage office's full street address. Requires `property_details`. All brokerage office phone numbers, typed and flagged primary. Requires `property_details`. ## Code Examples ```bash cURL theme={null} curl -X GET "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=1&limit=50" \ -H "Authorization: Token YOUR_API_KEY" ``` ```python Python theme={null} import requests API_KEY = "YOUR_API_KEY" BASE_URL = "https://api.lobstr.io/v1" headers = {"Authorization": f"Token {API_KEY}"} params = { "squid": "YOUR_SQUID_HASH", "page": 1, "limit": 50 } all_results = [] url = f"{BASE_URL}/results" while True: response = requests.get(url, headers=headers, params=params) data = response.json() all_results.extend(data["data"]) print(f"Fetched page {data['page']} of {data['total_pages']}") if data["next"] is None: break url = data["next"] params = {} print(f"\nTotal listings collected: {len(all_results)}") for listing in all_results[:5]: print(f"- {listing.get('full_address')} — ${listing.get('price', 0):,} ({listing.get('bed')}bd/{listing.get('bath')}ba)") ``` ## Response ```json 200 theme={null} { "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" } ], "next": "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=2&limit=50", "previous": null } ```