Search candidate listings for a dynamic set.

GET 
/sets/candidates

Returns market listings near a location, with their trailing-year performance metrics, to choose from when building a dynamic set. Provide either a lat/long/radius (radius in meters) or one or more market_ids. Results are ordered nearest-first (each carries a distance_meters value) and paginated. Pass the returned listing_ids to POST /sets to add them as members. Not tied to a set, so no set plan applies.

Request

Responses

200

Array of candidate listings ordered nearest-first.

400

Neither lat/long/radius nor market_ids were provided, or lat/long/radius were not sent together.

401

API key authorization failed.

429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.