> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aris247.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Property Search

> Search MLS listings by location, price, bedrooms, and other criteria.

# Property Search

Searches MLS listings by location, price, bedrooms, and other criteria.

## MCP tool name

`search_listings`

## Parameters

<ParamField body="city" type="string">City name.</ParamField>
<ParamField body="state" type="string">Two-letter state code.</ParamField>
<ParamField body="zip" type="string">ZIP code.</ParamField>
<ParamField body="minPrice" type="number">Minimum price.</ParamField>
<ParamField body="maxPrice" type="number">Maximum price.</ParamField>
<ParamField body="minBeds" type="integer">Minimum bedrooms.</ParamField>
<ParamField body="maxBeds" type="integer">Maximum bedrooms.</ParamField>
<ParamField body="minBaths" type="number">Minimum bathrooms.</ParamField>
<ParamField body="maxBaths" type="number">Maximum bathrooms.</ParamField>
<ParamField body="minSqFt" type="integer">Minimum square footage.</ParamField>
<ParamField body="maxSqFt" type="integer">Maximum square footage.</ParamField>
<ParamField body="propertyType" type="string">`"Single Family"`, `"Condo"`, `"Townhouse"`, etc.</ParamField>
<ParamField body="limit" type="integer" default="12">Max results (max 24).</ParamField>

At least one filter is required (city, state, zip, or price range).

## Example

<Tabs sync={false}>
  <Tab title="Natural language">
    > "Show me 3-bedroom condos under \$400k in Denver"

    The AI extracts: `city: "Denver"`, `maxPrice: 400000`, `minBeds: 3`, `propertyType: "Condo"`
  </Tab>

  <Tab title="MCP">
    ```json theme={null}
    {
      "name": "search_listings",
      "arguments": {
        "city": "Denver",
        "maxPrice": 400000,
        "minBeds": 3,
        "propertyType": "Condo"
      }
    }
    ```
  </Tab>

  <Tab title="REST API">
    ```bash theme={null}
    curl -X POST .../v1/listings/search \
      -H "X-ARIS-API-Key: aris_yourkey" \
      -d '{"city":"Denver","maxPrice":400000,"minBeds":3,"propertyType":"Condo"}'
    ```
  </Tab>
</Tabs>

## Response

Returns a JSON array of listing objects with address, price, beds, baths, sqft, photos, and detail URLs. See [POST /v1/listings/search](/docs/api/listings-search) for the full schema.