furnishedfinder.com APIwww.furnishedfinder.com ↗
Search FurnishedFinder.com listings via API. Filter furnished monthly rentals by location, bedrooms, bathrooms, and map bounds with full pagination support.
curl -X GET 'https://api.parse.bot/scraper/a6d88dfe-0818-48e3-bf75-7776fab6e551/search_locations?query=San+Francisco%2C+CA' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for locations by text to get encoded location IDs for use in search_rentals. Returns up to 5 location suggestions with encoded IDs that can be passed to search_rentals.
| Param | Type | Description |
|---|---|---|
| query | string | Location search text (city, state, address, or landmark name) |
{
"type": "object",
"fields": {
"query": "string - the search text submitted",
"locations": "array of location suggestions, each with encoded_location and description"
},
"sample": {
"data": {
"query": "San Francisco, CA",
"locations": [
{
"description": "San Francisco, CA",
"encoded_location": "us--ca--san-francisco--gp_ChIJIQBpAG2ahYAR_6128GcTUEo"
},
{
"description": "California Academy of Sciences, Music Concourse Drive, San Francisco, CA",
"encoded_location": "us--ca--san-francisco--music-concourse-drive--california-academy-of-sciences--gp_ChIJIUT7rEOHhYARucp3wM-HhBs"
}
]
},
"status": "success"
}
}About the furnishedfinder.com API
The FurnishedFinder API gives developers access to furnished monthly rental listings through 2 endpoints. Use search_locations to resolve a city name or address into an encoded location ID, then pass that ID to search_rentals to retrieve listings with pricing, availability, amenities, and geographic coordinates. Each listing response includes pagination metadata so you can traverse large result sets page by page.
Endpoints Overview
The API consists of two endpoints designed to work in sequence. search_locations accepts a free-text query — a city name, state, address, or landmark — and returns up to 5 location suggestions. Each suggestion includes an encoded_location string (e.g. us--ca--san-francisco--gp_ChIJIQBpAG2ahYAR_6128GcTUEo) and a human-readable description. This encoded ID is the required input for the second endpoint.
Searching Rental Listings
search_rentals accepts the location parameter from search_locations and supports additional filters: bedrooms, bathrooms, and a geographic bounding box defined by ne_lat, ne_lon, sw_lat, and sw_lon. Results are paginated; the response includes total_results, total_pages, current_page, has_next_page, and has_previous_page so you can walk through all matching listings. Each listing object in the listings array contains property details, pricing, availability dates, amenity flags, and location data.
Response Shape and Coverage
The search_rentals response surfaces per-listing fields that cover the core data shown on FurnishedFinder property cards: price, bedroom and bathroom counts, availability, and property-level amenities. The bounding-box parameters (ne_lat, ne_lon, sw_lat, sw_lon) allow map-viewport-driven queries, which is useful when building a map interface where the search area shifts as the user pans. Pagination is 1-based via the page parameter.
Data Source Context
FurnishedFinder.com does not publish an official public developer API. The data accessible through this API reflects the listings available on the site, focused on the furnished, mid-term rental market — primarily monthly stays targeted at traveling nurses, remote workers, and similar tenants.
- Build a map-based furnished rental search using bounding-box parameters to query listings within the visible viewport
- Aggregate furnished monthly rental inventory across multiple cities by iterating
search_rentalswith different encoded location IDs - Filter available 2-bedroom furnished rentals in a specific metro area using the
bedroomsandlocationparameters - Track pricing and availability changes for furnished rentals in a given market over time
- Power a relocation tool for traveling healthcare workers by surfacing furnished short-term housing near hospital locations
- Compare bedroom and bathroom count distributions across neighborhoods using paginated listing data
- Integrate furnished rental listings into a corporate housing portal using the amenities and availability fields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FurnishedFinder have an official developer API?+
What does `search_rentals` return for each listing?+
listings array includes property details, pricing, availability dates, amenity information, and location data. The response envelope also carries total_results, total_pages, current_page, has_next_page, and has_previous_page for pagination.How does the two-endpoint workflow operate?+
search_locations takes a text query and returns up to 5 location suggestions, each with an encoded_location ID. You pass that ID as the location parameter in search_rentals. The bounding-box parameters (ne_lat, ne_lon, sw_lat, sw_lon) are optional and let you narrow results to a specific map area.Can I filter by price range or property type?+
search_rentals supports filtering by bedrooms, bathrooms, and geographic bounding box, but price range and property type filters are not exposed. You can fork this API on Parse and revise it to add those filters if the underlying data surface supports them.