FurnishedFinder APIfurnishedfinder.com ↗
Search furnished monthly rentals on FurnishedFinder.com. Access listings with pricing, availability, amenities, and location data via 2 endpoints.
What is the FurnishedFinder API?
The FurnishedFinder API provides access to furnished monthly rental listings across the United States through 2 endpoints. Use search_locations to resolve a city, address, or landmark into an encoded location ID, then pass that ID to search_rentals to retrieve listings with pricing, bedroom and bathroom counts, amenities, availability, and pagination metadata. Results can be filtered by bedrooms, bathrooms, and geographic bounding box.
curl -X GET 'https://api.parse.bot/scraper/a6d88dfe-0818-48e3-bf75-7776fab6e551/search_locations?query=Austin%2C+TX' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace furnishedfinder-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: FurnishedFinder SDK — search locations, browse rentals with filters."""
from parse_apis.furnished_finder_rentals_api import (
FurnishedFinder, PropertyType, LocationNotFound
)
client = FurnishedFinder()
# Search for locations to get encoded IDs for rental searches.
for loc in client.locations.search(query="Austin, TX", limit=3):
print(loc.encoded_location, loc.description)
# Construct a Location by encoded ID and search its rentals with filters.
nyc = client.location(name="us--ny--new-york--gp_ChIJOwg_06VPwokRYv534QaPC8g")
listing = nyc.rentals.search(
property_type=PropertyType.APARTMENT,
min_price=2000,
max_price=5000,
limit=1,
).first()
if listing:
print(listing.name, listing.rent_amount, listing.bedrooms, listing.is_available_now)
# Typed error handling for a location that yields no results.
try:
results = client.locations.search(query="Nonexistent Place XYZ", limit=1)
first = results.first()
if first:
print(first.description)
except LocationNotFound as exc:
print(f"Location not found: {exc.query}")
print("exercised: locations.search / location().rentals.search / PropertyType enum / LocationNotFound error")
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. The encoded_location value from each result is the primary input 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 LocationSuggestion objects with encoded_location and description"
},
"sample": {
"data": {
"query": "Austin, TX",
"locations": [
{
"description": "Austin, TX",
"encoded_location": "us--tx--austin--gp_ChIJLwPMoJm1RIYRetVp1EtGm10"
},
{
"description": "TX-130, Austin, TX",
"encoded_location": "us--tx--austin--TX~130--gp_EhJUWC0xMzAsIEF1c3RpbiwgVFgiLiosChQKEglPGAtjvbdEhhETTZp2TATNShIUChIJLwPMoJm1RIYRetVp1EtGm10"
}
]
},
"status": "success"
}
}About the FurnishedFinder API
Endpoints Overview
The API has two endpoints. 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 and a human-readable description. The encoded_location value is a slug-style ID (e.g. us--ca--san-francisco--gp_ChIJIQ...) and is the required input to the second endpoint.
Searching Rental Listings
search_rentals takes the encoded_location from the first endpoint and returns a paginated list of furnished rental listings. Each listing object includes property details, monthly pricing, availability, bedroom and bathroom counts, and amenity data. Pagination is handled via the page parameter, and the response includes total_results, total_pages, current_page, has_next_page, and has_previous_page so you can iterate through large result sets without guesswork.
Filtering and Bounding Box Support
Filters for bedrooms and bathrooms accept string values such as "1", "2", or "3". Geographic filtering is available through a map viewport bounding box: supply ne_lat, ne_lon, sw_lat, and sw_lon to constrain results to a specific map area. Bounding box and encoded location filters can be used together, giving you control over both the search anchor and the visible map region.
Coverage and Data Shape
FurnishedFinder focuses on furnished, monthly-term rentals aimed at travel nurses, remote workers, and other mid-term tenants. Listings are US-based. The response exposes the field set presented on FurnishedFinder listing pages, including location coordinates alongside property and pricing details.
The FurnishedFinder API is a managed, monitored endpoint for furnishedfinder.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when furnishedfinder.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official furnishedfinder.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate furnished mid-term rental inventory for a relocation or travel nurse housing platform.
- Build a map-based rental search UI using the bounding box parameters to sync results with a visible viewport.
- Monitor monthly rental prices in a specific city by repeatedly querying
search_rentalswith the same encoded location. - Compare bedroom and bathroom counts across listings in a metro area using the bedrooms and bathrooms filters.
- Feed furnished rental availability data into a corporate housing or employee relocation tool.
- Analyze furnished rental supply across multiple cities by iterating over locations from
search_locations.
| 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 | 100 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?+
total_results, total_pages, current_page, has_next_page, and has_previous_page — are returned at the top level alongside the listings array.Does the API expose individual listing detail pages or host reviews?+
search_rentals, including pricing, amenities, availability, and location. Individual listing detail pages and any host or tenant reviews are not included. You can fork this API on Parse and revise it to add a listing-detail endpoint.How does pagination work in `search_rentals`?+
page parameter is 1-based. The response includes total_pages, current_page, results_on_page, has_next_page, and has_previous_page. You can determine whether to fetch additional pages from has_next_page without needing to calculate totals manually.Is there a minimum number of filters required to call `search_rentals`?+
location (encoded ID from search_locations) or a bounding box (all four of ne_lat, ne_lon, sw_lat, sw_lon) to get geographically meaningful results. The bedrooms and bathrooms filters narrow results further but are not required.