Search
Search listings from your approved feed with a full set of filters. Results are paginated and ordered by list date descending by default.
Endpoint
GET /api/v1/search
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
location | string | No | City name, ZIP code, neighborhood, or address keyword |
max_price | number | No | Maximum list price in USD |
min_price | number | No | Minimum list price in USD |
min_beds | number | No | Minimum number of bedrooms |
max_beds | number | No | Maximum number of bedrooms |
min_baths | number | No | Minimum number of bathrooms |
status | string | No | active, pending, sold, expired or withdrawn. Default: active. Display availability follows the approved feed. |
property_type | string | No | A feed-supported property type, such as single, condo, multi or land |
sort | string | No | newest, oldest, price_asc, price_desc, sqft_asc, sqft_desc, beds_asc, beds_desc, baths_asc, baths_desc, year_asc, year_desc, dom_asc or dom_desc |
page | integer | No | Page number from 1 to 10,000. Default: 1 |
per_page | integer | No | Results per page. Range: 1-50. Default: 20 |
Example request
Search listings
curl -H "Authorization: Bearer eai_YOUR_KEY" \ -H "X-EAI-Site-ID: site_YOUR_SITE_ID" \ "https://app.easyagentidx.com/api/v1/search" \ -G \ -d "location=La Jolla CA" \ -d "max_price=3000000" \ -d "status=active"
→ 200 OK { "data": [...listings], "meta": { "total": 94, "page": 1, "per_page": 20 } }
Response
Returns a paginated array of listing objects. See the Listings page for the full field reference.