rental_readiness

Search the SF rental index; every row carries source and last-seen date. Partner keys get the free sample tier, never the full index.

Search PutRoots' San Francisco rental index. Every row carries its source, the date we last saw it, and whether the landlord stated any requirements at all. Use this when someone asks what's available in SF at a price / bedroom count / neighborhood. Without a signed-in PutRoots account this searches the free sample only (3 listings per bedroom tier) and says so, with the true total.

get/v1/listings

Request

  • Base URL: https://www.putroots.com
  • URL: https://www.putroots.com/v1/listings
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Query parameters

max_pricenumber

Max monthly rent in USD. Listings with no stated price are excluded when you set this — we don't let unpriced posts through a price filter.

min_pricenumber

Min monthly rent in USD.

beds'room' | 'studio' | '1' | '2' | '3+'

Bedroom tier. "room" means a room in a shared place.

hoodstring

Neighborhood name, matched loosely (e.g. "Mission", "Sunset").

limitinteger

How many to return (default 10, max 25). Newest first.

Response

OK

sourceunknown required
fetched_atstring date-time required
gatedboolean required

true = free sample only (anonymous or partner key); total still tells the true index size.

totalinteger required
searchedinteger required
matchedinteger required
not_checked_vs_budgetinteger
listings_with_no_stated_requirementsinteger

Changes

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