Skip to main content
GET
/
v1.0
/
listing
Search by Agent / Office
curl --request GET \
  --url https://api.lofty.com/v1.0/listing \
  --header 'Authorization: <authorization>'
{
  "listIng": {},
  "soldListing": {},
  "get_listingMetadata": {
    "collection": "<string>",
    "limit": 123,
    "total": 123,
    "activeTotal": 123,
    "soldTotal": 123,
    "nextPageKey": "<string>",
    "soldNextPageKey": "<string>"
  }
}

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]

Query Parameters

userId
integer<int64>
default:0
listingId
string
default:""
nextPageKey
string
default:""
soldNextPageKey
string
default:""
mlsListingIds
string
default:""
street
string
default:""
limit
integer<int32>
default:25
soldListingId
string
default:""
officeListings
boolean
default:false
agentListings
boolean
default:false
buildingName
string
default:""
buildingAddress
string
default:""
showCondition
boolean
default:false

Response

Search result envelope with active listings, sold listings, and listing metadata.

Response for GET /v1.0/listing. Carries active-listing results, sold-listing results, and pagination / total metadata.

listIng
object

Active listings matching the search. Structure is a listing hub payload; fields depend on the listing source.

soldListing
object

Sold listings matching the search. Same structure as listIng.

get_listingMetadata
object

Listing search metadata: totals, pagination cursors, and filter echo.