Search by Location
AI-generatedSummary
Search properties by location, city, ZIP code, or county, and initiate an Apify extraction run returning property data from selected sources.
Inputs
- location (required) — City and state, ZIP code, or county. Examples: 'Denver, CO', '80202', 'Los Angeles County'.
- sources — Which platforms to extract from. Default: ['zillow']. Options: 'zillow' (includes Zestimate valuations), 'redfin' (includes Redfin Estimate).
- maxResults — Maximum properties to return. Default: 50. Range: 1-500.
- includeValuations — Whether to fetch Zestimate and valuation data. Default: true. Adds ~1s per property.
- waitForCompletion — Whether to wait for extraction to complete before returning results. Default: true.
- filters — Filters for property listing status, type, price, bedrooms, bathrooms, and square footage. Only active for searchLocation operation.
- additionalOptions — Stealth level, photo/include history settings, self-healing mode, and timeout for the extraction run.
Output shape
array of property items
If waitForCompletion is false, returns immediately with {success: true, status: 'RUNNING', runId, datasetId, message: 'Property extraction started. Use Get Run Status to check progress.'}. If true, polls the run status every 5 seconds up to the configured timeout (default 300s). On success, returns each property as a separate item with fields: zpid, address, city, state, zipCode, price, beds, baths, sqft, zestimate, rentZestimate, redfinEstimate, yearBuilt, lotSize, propertyType, listingStatus, daysOnMarket, photos, priceHistory, url, source, extractedAt, _runId, _datasetId. If the run fails and continueOnFail is true, returns an error object paired with the item.
Examples
Example 1: Basic location search returning 5 properties with valuations
location='Denver, CO', sources=['zillow'], maxResults=5, includeValuations=true, waitForCompletion=true
Example 2: Quick start with run ID for later status check
location='80202', sources=['redfin'], waitForCompletion=false