Skip to content
Examples

Get Results

Retrieve scraped data from Realtor Listings Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Realtor Listings Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

runstringquery

Hash of a specific run (optional).

pageintegerquery

Page number (default: 1).

page_sizeintegerquery

Results per page (default: 50, max: 100).

Result Fields

urlstring

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_addressstring

Full formatted address of the property. Example: 123 Main St, Los Angeles, CA 90001

streetstring

Street address. Example: 123 Main St

citystring

City name. Example: Los Angeles

statestring

US state abbreviation. Example: CA

countystring

County name. Example: Los Angeles County

zip_codestring

ZIP code. Example: 90001

statusstring

Listing status (e.g. for_sale, sold, pending). Example: for_sale

priceinteger

Listed price in USD. Example: 750000

sold_priceinteger

Final sold price (if applicable). Example: 740000

currencystring

Currency of the price. Example: USD

bedinteger

Number of bedrooms. Example: 3

bathnumber

Number of bathrooms. Example: 2.5

house_sizeinteger

Interior living area in square feet. Example: 1850

acre_lotnumber

Lot size in acres. Example: 0.15

property_typestring

Type of property (e.g. single_family, condo, townhouse). Example: single_family

is_new_constructionboolean

Whether the property is new construction. Example: false

is_to_be_builtboolean

Whether the property is to be built. Example: false

is_foreclosureboolean

Whether the listing is a foreclosure. Example: false

pendingboolean

Whether the listing is under contract/pending. Example: false

brokered_bystring

Name of the brokerage listing the property. Example: Keller Williams Realty

sellerstring

Primary seller or listing agent name.

co_sellerstring

Co-seller or co-listing agent name.

latnumber

Latitude coordinate of the property. Example: 34.052235

lngnumber

Longitude coordinate of the property. Example: -118.243683

image_urlstring

URL of the main listing photo.

published_atstring

Date the listing was first published. Example: 2026-03-10

list_datestring

Date the property was listed. Example: 2026-03-10

sold_datestring

Date the property was sold (if applicable). Example: 2026-03-28

last_status_change_datedatetime

Date the listing status last changed (e.g. listed → pending). Example: 2026-04-02

year_builtinteger

Year the property was built. Example: 1998

hoa_feeinteger

Monthly HOA fee in USD. Example: 250

price_per_sqftinteger

Price per square foot. Example: 405

agent_namestring

Listing agent's display name. Example: Jane Smith

agent_phonestring

Listing agent's phone number. Example: +13105550142

agent_emailstring

Listing agent email address. Example: jane.smith@kw.com

office_namestring

Brokerage office name. Example: Keller Williams Realty

office_phonestring

Brokerage office phone number. Example: +13105550100

builder_namestring

Builder name for new-construction listings. Example: Pulte Homes

sub_typestring

Property sub-type (e.g. co_op, condo, townhouse). Example: townhouse

garageinteger

Number of garage spaces. Example: 2

neighborhoodstring

Neighborhood name. Example: Silver Lake

neighborhoodsjson

All neighborhood names for the listing (when multiple apply). Example: ["Silver Lake", "Eastside"]

county_fips_codestring

County FIPS code, for joining to census or market data. Example: 06037

street_view_urlstring

Google Street View image URL for the property.

virtual_tour_urlstring

Virtual tour / 3D walkthrough URL.

is_price_reducedboolean

Whether the price was recently reduced. Example: false

is_contingentboolean

Whether the listing is contingent. Example: false

is_coming_soonboolean

Whether the listing is marked as coming soon. Example: false

is_new_listingboolean

Whether the listing was added in the last 14 days. Example: true

price_reduced_amountinteger

Amount of the most recent price reduction in USD. Example: 25000

open_housesjson

Scheduled open house dates and times, when available.

mls_idstring

MLS listing ID. Example: SR26054321

property_idstring

Realtor.com internal property ID. Example: M12345-67890

storiesinteger

Number of stories in the property. Example: 2

year_renovatedinteger

Year the property was last renovated. Example: 2018

Detail Fields

These fields require property_details: true:

photosjson

Full photo gallery (list of image URLs). Requires property_details.

photo_countinteger

Total number of photos. Requires property_details. Example: 42

photo_tagsjson

Per-photo metadata: AI-generated room tags (e.g. kitchen, bedroom), title and description for each photo. Requires property_details.

description_textstring

Full listing description text. Requires property_details.

property_historyjson

Price and sale event timeline. Requires property_details.

tax_historyjson

Yearly tax, assessment and market valuations. Requires property_details.

building_permits_historyjson

Building permit history with project, type of work, project type, and effective date. Requires property_details.

schoolsjson

Rated nearby schools with grades, ratings and distance. Requires property_details.

spec_detailsjson

Full spec sheet grouped by category (interior, exterior, HOA, etc.). Requires property_details.

amenity_tagsjson

Structured amenity tags, each with a stable id and human-readable label. Requires property_details.

baths_fullinteger

Number of full bathrooms. Requires property_details. Example: 2

baths_halfinteger

Number of half bathrooms. Requires property_details. Example: 1

baths_3qtrinteger

Number of three-quarter bathrooms. Requires property_details. Example: 0

baths_totalinteger

Total bathroom count. Requires property_details. Example: 3

beds_maxinteger

Upper bound of bedroom count for multi-unit listings. Requires property_details.

beds_mininteger

Lower bound of bedroom count for multi-unit listings. Requires property_details.

sqft_maxinteger

Upper bound of square footage for multi-unit listings. Requires property_details.

sqft_mininteger

Lower bound of square footage for multi-unit listings. Requires property_details.

garage_typestring

Garage type (e.g. attached, detached). Requires property_details.

coolingstring

Cooling system description. Requires property_details. Example: Central Air

heatingstring

Heating system description. Requires property_details. Example: Forced Air

roofingstring

Roofing material. Requires property_details. Example: Composition

exteriorstring

Exterior material. Requires property_details. Example: Stucco

constructionstring

Construction material. Requires property_details. Example: Wood Frame

stylesstring

Architectural style. Requires property_details. Example: Contemporary

poolstring

Pool features. Requires property_details. Example: In Ground

fireplacestring

Fireplace features. Requires property_details. Example: Gas

roomsstring

Total room count. Requires property_details. Example: 8

unitsstring

Number of units or unit type. Requires property_details.

zoningstring

Zoning designation. Requires property_details. Example: R1

fema_zonestring

FEMA flood zone designation(s), comma-separated. Requires property_details. Example: X

noise_scoreinteger

Local noise score. Requires property_details. Example: 42

noise_categoriesjson

Noise source breakdown (e.g. traffic, airports). Requires property_details.

flood_factor_scoreinteger

Flood Factor risk score 1–10. Requires property_details. Example: 2

flood_factor_severitystring

Flood Factor severity label. Requires property_details. Example: Minimal

flood_trend_directioninteger

Direction of change in flood risk over time. Requires property_details.

flood_trendstring

Short summary of the flood risk trend. Requires property_details.

flood_trend_paragraphstring

Full paragraph describing the flood risk trend. Requires property_details.

flood_insurance_textstring

Narrative flood insurance guidance. Requires property_details.

flood_insurance_requirementstring

Whether flood insurance is required or recommended. Requires property_details.

flood_firststreet_urlstring

Link to the First Street flood risk report. Requires property_details.

flood_fsidstring

First Street flood risk record ID. Requires property_details.

flood_insurance_ratesjson

Flood insurance quotes by provider. Requires property_details.

environmental_riskinteger

Environmental flood risk score (similar scale to flood_factor_score). Requires property_details.

fire_factor_scoreinteger

Wildfire Factor risk score 1–10. Requires property_details. Example: 1

fire_factor_severitystring

Wildfire Factor severity label. Requires property_details. Example: Minor

fire_cumulative_30string

Cumulative wildfire risk over the next 30 years. Requires property_details.

fire_trendstring

Short summary of the wildfire risk trend. Requires property_details.

fire_trend_paragraphstring

Full paragraph describing the wildfire risk trend. Requires property_details.

fire_insurance_textstring

Narrative wildfire insurance guidance. Requires property_details.

usfs_relative_riskstring

US Forest Service relative wildfire risk narrative. Requires property_details.

fire_firststreet_urlstring

Link to the First Street wildfire risk report. Requires property_details.

fire_fsidstring

First Street wildfire risk record ID. Requires property_details.

fire_insurance_ratesjson

Wildfire insurance quotes by provider. Requires property_details.

is_non_deededboolean

Whether ownership is non-deeded (e.g. co-op share). Requires property_details.

is_fractionally_ownedboolean

Whether the property is fractionally owned. Requires property_details.

is_price_excludes_landboolean

Whether the listed price excludes the land. Requires property_details.

is_usda_eligibleboolean

Whether the property is USDA loan eligible. Requires property_details.

is_short_saleboolean

Whether the listing is a short sale. Requires property_details.

is_auctionboolean

Whether the listing is an auction. Requires property_details.

is_subdivisionboolean

Whether the property is part of a subdivision. Requires property_details.

street_numberstring

Parsed street number. Requires property_details. Example: 123

street_namestring

Parsed street name. Requires property_details. Example: Main

street_suffixstring

Parsed street suffix. Requires property_details. Example: St

street_directionstring

Parsed street direction prefix. Requires property_details. Example: N

unitstring

Parsed unit or apartment number. Requires property_details. Example: 4B

search_areasjson

Broader search areas (city/state/county) the listing belongs to. Requires property_details.

hot_market_badgestring

Local housing market heat badge for the postal code. Requires property_details. Example: Hot

state_licensestring

Listing agent's state real estate license number. Requires property_details.

agent_nrds_idstring

Agent's NRDS ID — a stable identifier for deduping the same agent across listings. Requires property_details.

agent_idstring

Stable agent identifier. Requires property_details.

agent_hrefstring

URL to the agent's Realtor.com profile. Requires property_details.

agent_sloganstring

Agent's tagline or slogan. Requires property_details.

agent_mls_setstring

Agent's MLS set identifier. Requires property_details.

agent_photo_urlstring

Agent's profile photo URL. Requires property_details.

agent_addressjson

Agent's business address. Requires property_details.

agent_phonesjson

All agent phone numbers, typed (mobile, office, etc.) and flagged primary. Requires property_details.

team_idstring

Stable team identifier when the agent belongs to a team. Requires property_details.

team_namestring

Team name when the agent belongs to a team. Requires property_details.

broker_namestring

Broker (brokerage company) name. Requires property_details.

broker_idstring

Stable broker identifier. Requires property_details.

broker_logostring

Broker logo image URL. Requires property_details.

broker_accent_colorstring

Broker's brand accent color. Requires property_details.

broker_designationsjson

Broker designations or certifications. Requires property_details.

office_idstring

Stable brokerage office identifier. Requires property_details.

office_namestring

Brokerage office name. Requires property_details.

office_emailstring

Brokerage office contact email. Requires property_details.

office_hrefstring

URL to the brokerage office's Realtor.com profile. Requires property_details.

office_sloganstring

Brokerage office tagline or slogan. Requires property_details.

office_mls_setstring

Brokerage office's MLS set identifier. Requires property_details.

office_application_urlstring

Office rental or application URL, when available. Requires property_details.

office_out_of_communityboolean

Whether the office is outside the listing's community. Requires property_details.

office_hoursjson

Brokerage office business hours. Requires property_details.

office_lead_emailstring

Office's direct lead-contact email. Requires property_details.

office_photo_urlstring

Brokerage office photo or logo URL. Requires property_details.

office_addressjson

Brokerage office's full street address. Requires property_details.

office_phonesjson

All 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

200
{
  "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
}