FurnishedFinder APIfurnishedfinder.com ↗
Search furnished monthly rentals on FurnishedFinder.com. Access listings, pricing, amenities, landlord info, and photos via 3 structured endpoints.
What is the FurnishedFinder API?
The FurnishedFinder API gives developers access to furnished monthly rental listings through 3 endpoints covering location lookup, listing search, and full property detail retrieval. The search_rentals endpoint returns paginated results with pricing, availability, bedroom and bathroom counts, amenities, and photo thumbnails, while get_listing_details adds landlord profiles, fee breakdowns, house rules, and per-room breakdowns for a single property.
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'
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
Location and Listing Search
Start with search_locations, which accepts a freeform query string (city name, address, or landmark) and returns up to 5 location suggestions, each carrying an encoded_location value and a human-readable description. That encoded_location string is the primary input to search_rentals. Without it, you can still query search_rentals by passing a bounding box using ne_lat, ne_lon, sw_lat, and sw_lon to target a map viewport directly.
Filtering and Pagination in search_rentals
search_rentals supports filtering by bedrooms and bathrooms (passed as string values like "2"). Pagination is handled through the page parameter; the response includes total_pages, total_results, current_page, has_next_page, and has_previous_page so you can walk through result sets programmatically. Each listing object in the listings array includes property details, pricing, availability windows, amenity tags, and photo thumbnails.
Full Listing Detail
get_listing_details accepts a listing_id from search_rentals results and returns the complete record for that property. This includes the full photos array with per-photo caption and image_url, a bedrooms object with count and a typed list of individual rooms, a matching bathrooms object, an amenities string array, a fees array with type and amount, and a landlord object carrying name, biography, confirmed_info, response_time, and profile_image. Geographic coordinates (latitude) are also present at the listing level.
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?+
- Build a furnished rental search tool filtered by bedroom count and geographic bounding box for travel nurses or relocating employees
- Aggregate landlord response times and confirmed-info flags to surface higher-trust listings for tenant-facing applications
- Map rental density and pricing across a city by paginating search_rentals results with ne_lat/sw_lat bounding box parameters
- Display full photo galleries with captions for individual properties using the photos array from get_listing_details
- Compare monthly fee structures across listings by extracting the fees array (type and amount) from get_listing_details
- Power a neighborhood-level rental availability widget using total_results counts from multiple encoded_location queries
- Sync amenity tags from the amenities array to filter or rank properties for specific tenant requirements such as pet-friendliness or parking
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.