Skip to main content
POST
/
v2.0
/
listings
/
search
Search Listings
curl --request POST \
  --url https://api.lofty.com/v2.0/listings/search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "searchScope": "all",
  "soldFlag": true,
  "filterConditions": {},
  "sortFields": [
    "<string>"
  ],
  "returnFields": [
    "<string>"
  ],
  "pageNum": 1,
  "pageSize": 25
}
'
{
  "listing": [
    {
      "listingId": "1179625482",
      "mlsListingId": "ML82040728",
      "listingStreetName": "5164 Montreal DR",
      "listingCity": "San Jose",
      "listingState": "CA",
      "listingZipcode": [
        "<string>"
      ],
      "county": "Santa Clara",
      "area": "Campbell",
      "chimeArea": "<string>",
      "subDivisionName": "<string>",
      "community": "<string>",
      "chimeComplex": "<string>",
      "price": "1950000",
      "beds": 3,
      "baths": 2,
      "sqft": 1408,
      "builtYear": 1959,
      "totalAvailableAcres": "6000",
      "detailsDescribe": "<string>",
      "listingStatus": "Active",
      "purchaseType": "For Sale",
      "propertyTypes": [
        "<string>"
      ],
      "propertyTypePrimary": "Residential",
      "propertyTypeSecondary": "Single Family Home",
      "pictureList": [
        "<string>"
      ],
      "openHouseSchedules": "Sat Apr 04, 1:00pm - 4:00pm",
      "openHouseSchedulesStart": "2026-04-04 13:00:00",
      "openHouseSchedulesEnd": "2026-04-04 16:00:00",
      "agentId": "5106715",
      "agentName": "Dawn Thorburn",
      "agentOrgId": "6043409",
      "agentOrgName": "Rocky Properties Inc.",
      "coAgentId": "<string>",
      "coAgentName": "<string>",
      "coAgentOrgId": "<string>",
      "coAgentOrgName": "<string>",
      "hoaFee": -1,
      "hoaFeeFrequency": "<string>",
      "condoFee": -1,
      "condoFeeFrequency": "<string>",
      "chimeMaintenanceFee": 0,
      "garageParkingSpaces": 2,
      "interiorFeatures": "<string>",
      "exterior": "<string>",
      "mlsListDateL": 0
    }
  ],
  "metadata": {
    "collection": "<string>",
    "pageSize": 123,
    "pageNum": 123,
    "totalCount": 123,
    "totalPage": 123,
    "hasMore": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.lofty.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string
required

Bearer [access_token]

​
Content-Type
string
required

application/json

Body

application/json
​
searchScope
enum<string>
default:all

Search scope. 'my' = agent's own listings, 'office' = office-level listings, 'all' = all listings the agent has access to. Default 'all'.

Available options:
my,
office,
all
​
soldFlag
boolean

Whether to search sold listings. Default false (active listings).

​
filterConditions
object

Advanced search filter conditions. Keys must match condition names in the property.condition table. Examples:

  • "location": {"city": ["Seattle"]} (suggestion type)
  • "price": "100000,500000" (inputBox range: "min,max")
  • "beds": "2," (inputBox range: min only)
  • "baths": ",3" (inputBox range: max only)
  • "sqFt": "1000,3000" (inputBox range)
  • "daysOnSite": ",30" (inputBox days: within last N days)
  • "propertyType": ["Condo", "Townhouse"] (multiSelect labels)
  • "purchaseType": ["For Sale"] (singleSelect label)
​
sortFields
string[]

Sort fields. Values from ListingSortEnum, e.g. MLS_LIST_DATE_L_DESC, PRICE_DESC, PRICE_ASC, BEDROOMS_DESC, BATHS_DESC, BUILT_YEAR_DESC, SQFT_DESC, RELEVANCE, QUALITY_DESC, OPEN_HOUSE_DESC.

​
returnFields
string[]

Return fields. If empty, uses default fields for the listing type.

​
pageNum
integer<int32>
default:1

Page number, starting from 1. Default 1.

​
pageSize
integer<int32>
default:25

Page size, 1–100. Default 25.

Response

200 - application/json

successful operation

Search response for ListingV2

​
listing
object[]
​
metadata
object