listings_list
Search for property listings by address, MLS number, status, or price range.
Last updated
Search for property listings by address, MLS number, status, or price range. Returns pagination info (total_count, has_more, offset, limit) for batch operations. Results include: id, property_address, city, state, zip_code, list_price, listing_status, property_type, bedrooms, bathrooms, square_feet, created_at. Filter by status to find active listings vs sold/expired. Use min_price/max_price to match buyer budgets. For a specific listing by ID, use listings_get instead. For aggregate stats, use listings_stats. Default limit is 20 when not provided; if the default is used and more results exist, the response includes truncated: true and total: N so you can rerun with a higher limit.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Search term — matches against property_address, city, and mls_number (case-insensitive partial match). |
status | enum | No | Filter by listing status. active=on market, pending=under contract, sold=closed, expired=listing ended, coming_soon=pre-market (default: all). · One of: all, active, pending, sold, expired, cancelled, coming_soon |
min_price | number | No | Minimum listing price in dollars. Use with max_price for buyer matching. · Min: 0 |
max_price | number | No | Maximum listing price in dollars. Use with min_price for buyer matching. · Min: 0 |
property_type | enum | No | Filter by property type. · One of: single_family, condo, townhouse, multi_family, land, commercial |
limit | number | No | Maximum results (default: 20, max: 500). When omitted and more results exist, response includes truncated: true + total: N. · Max: 500 · Min: 1 |
offset | number | No | Skip N results for pagination (default: 0). · Min: 0 |
Example prompts#
- "Find active single family listings between 400k and 550k for the Garcias."
- "Search my listings for anything on Birchwood Ln in Bakersfield."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.
Previous name#
This tool was previously published as search_listings. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.