Skip to main content
POST
/
v1
/
listings
/
search
POST /v1/listings/search
curl --request POST \
  --url https://api.example.com/v1/listings/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "city": "<string>",
  "state": "<string>",
  "zip": "<string>",
  "minPrice": 123,
  "maxPrice": 123,
  "minBeds": 123,
  "maxBeds": 123,
  "minBaths": 123,
  "maxBaths": 123,
  "minSqFt": 123,
  "maxSqFt": 123,
  "propertyType": "<string>",
  "hasPool": true,
  "isWaterfront": true,
  "hasGarage": true,
  "semanticQuery": "<string>",
  "mode": "<string>",
  "limit": 123
}
'
Search MLS property listings. Routes automatically to IDX Broker or the brokerage’s custom database based on their integration type.

Request

curl -X POST \
  "https://dqgynnlsclfbqysauesf.supabase.co/functions/v1/api-router/v1/listings/search" \
  -H "Content-Type: application/json" \
  -H "X-ARIS-API-Key: aris_yourkey" \
  -d '{
    "city": "Austin",
    "state": "TX",
    "maxPrice": 500000,
    "minBeds": 3,
    "mode": "hybrid",
    "semanticQuery": "modern home with updated kitchen",
    "limit": 12
  }'

Body parameters

city
string
City name.
state
string
Two-letter state code.
zip
string
ZIP code.
minPrice
number
Minimum listing price.
maxPrice
number
Maximum listing price.
minBeds
integer
Minimum bedrooms.
maxBeds
integer
Maximum bedrooms.
minBaths
number
Minimum bathrooms.
maxBaths
number
Maximum bathrooms.
minSqFt
integer
Minimum square footage.
maxSqFt
integer
Maximum square footage.
propertyType
string
"Single Family", "Condo", "Townhouse", etc.
hasPool
boolean
Filter for homes with a pool.
isWaterfront
boolean
Filter for waterfront properties.
hasGarage
boolean
Filter for homes with a garage.
semanticQuery
string
Natural language query for ranking.
mode
string
default:"hybrid"
Search mode: structured_only, keyword, semantic, or hybrid.
limit
integer
default:"12"
Max results (max 24).

Search modes

ModeDescription
structured_onlyOnly hard filters, no ranking
keywordFull-text search boost on top of filters
semanticVector similarity ranking
hybridCombines keyword and semantic ranking (recommended)

Response

{
  "listings": [
    {
      "listingId": "a12345",
      "address": "123 Main St, Austin, TX 78701",
      "city": "Austin",
      "state": "TX",
      "zip": "78701",
      "price": "450000",
      "beds": 3,
      "baths": 2,
      "sqft": "1850",
      "photos": ["https://..."],
      "daysOnMarket": 14,
      "description": "Beautiful 3-bed home with updated kitchen...",
      "status": "Active",
      "detailsUrl": "https://...",
      "videoUrls": [{"url": "https://...", "title": "Virtual Tour"}]
    }
  ],
  "total": 47,
  "returned": 12,
  "searchCriteria": {"city": "Austin", "maxPrice": 500000, "minBeds": 3}
}