Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "url": "<string>",
  "full_address": "<string>",
  "street": "<string>",
  "city": "<string>",
  "state": "<string>",
  "county": "<string>",
  "zip_code": "<string>",
  "status": "<string>",
  "price": 123,
  "sold_price": 123,
  "currency": "<string>",
  "bed": 123,
  "bath": 123,
  "house_size": 123,
  "acre_lot": 123,
  "property_type": "<string>",
  "is_new_construction": true,
  "is_to_be_built": true,
  "is_foreclosure": true,
  "pending": true,
  "brokered_by": "<string>",
  "seller": "<string>",
  "co_seller": "<string>",
  "lat": 123,
  "lng": 123,
  "image_url": "<string>",
  "published_at": "<string>",
  "list_date": "<string>",
  "sold_date": "<string>"
}

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.

Retrieve scraped data from your Realtor Listings Scraper runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

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

​
Result Fields

​
url
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
​
full_address
string
Full formatted address of the property. Example: 123 Main St, Los Angeles, CA 90001
​
street
string
Street address. Example: 123 Main St
​
city
string
City name. Example: Los Angeles
​
state
string
US state abbreviation. Example: CA
​
county
string
County name. Example: Los Angeles County
​
zip_code
string
ZIP code. Example: 90001
​
status
string
Listing status (e.g. for_sale, sold, pending). Example: for_sale
​
price
integer
Listed price in USD. Example: 750000
​
sold_price
integer
Final sold price (if applicable). Example: 740000
​
currency
string
Currency of the price. Example: USD
​
bed
integer
Number of bedrooms. Example: 3
​
bath
number
Number of bathrooms. Example: 2.5
​
house_size
integer
Interior living area in square feet. Example: 1850
​
acre_lot
number
Lot size in acres. Example: 0.15
​
property_type
string
Type of property (e.g. single_family, condo, townhouse). Example: single_family
​
is_new_construction
boolean
Whether the property is new construction. Example: false
​
is_to_be_built
boolean
Whether the property is to be built. Example: false
​
is_foreclosure
boolean
Whether the listing is a foreclosure. Example: false
​
pending
boolean
Whether the listing is under contract/pending. Example: false
​
brokered_by
string
Name of the brokerage listing the property. Example: Keller Williams Realty
​
seller
string
Primary seller or listing agent name.
​
co_seller
string
Co-seller or co-listing agent name.
​
lat
number
Latitude coordinate of the property. Example: 34.052235
​
lng
number
Longitude coordinate of the property. Example: -118.243683
​
image_url
string
URL of the main listing photo.
​
published_at
string
Date the listing was first published. Example: 2026-03-10
​
list_date
string
Date the property was listed. Example: 2026-03-10
​
sold_date
string
Date the property was sold (if applicable). Example: 2026-03-28

​
Code Examples

curl -X GET "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=1&limit=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"
    }
  ],
  "next": "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=2&limit=50",
  "previous": null
}