listings_list
Search for property listings by address, MLS number, status, or price range.
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.