Search stays

Find live listings near a place, optionally for dates and a party. With dates, each result has availability (likely, from cached calendars) and an indicative_total. Always get a quote before stating a price.

get/v1/search

Request

Base URL: https://threshold.rentals/api
URL: https://threshold.rentals/api/v1/search
Auth: one of:
- none
- HTTP bearer

Query parameters

placestring

Town and state or region, e.g. "Asheville, NC". Or use near.

nearstring

lat,lng to search around instead of place.

radius_kmnumber

Search radius around place or near.

countrystring

ISO country code, e.g. US.

check_instring date

Example:2026-11-13

Give with check_out.

check_outstring date

Example:2026-11-13

Give with check_in.

adultsinteger

childreninteger

infantsinteger

petsinteger

min_bedroomsinteger

amenitiesstring[]

Comma-separated amenity codes; every one must match.

property_typesstring[]

Comma-separated; any may match.

step_free_entranceboolean

Only places with a step-free entrance.

bedroom_on_entry_levelboolean

Only places with a bedroom on the entry level.

min_wifi_mbpsnumber

Minimum host-reported Wi-Fi download speed.

max_totalinteger

Maximum indicative total for the dates, in cents. Needs check_in and check_out.

limitinteger

cursorstring

next_cursor from the previous page.

Response

Matching stays, closest and available first

next_cursorstring nullable

Example response

{
  "results": [
    {
      "indicative_total": {
        "currency": "USD"
      },
      "compare_at": {
        "estimated_total": {
          "currency": "USD"
        },
        "savings": {
          "currency": "USD"
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.