# Furnishedfinder — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for furnished monthly rental listings on FurnishedFinder.com by location and property details. Filter results by price, bedrooms, bathrooms, and property type, and browse available neighborhoods with pagination support.

**Category:** Real Estate | **Website:** [www.furnishedfinder.com/?utm_source=google&utm_medium=cpc&utm_campaign=Search+-+Tenants+-+V2&utm_content=Short+Term&utm_term=flat%20for%20short%20term%20rent&hsa_acc=7554573980&hsa_cam=21549710781&hsa_grp=166237664872&hsa_ad=708336038101&hsa_src=g&hsa_tgt=aud-2448728299609:kwd-1655286797901&hsa_kw=flat%20for%20short%20term%20rent&hsa_mt=p&hsa_net=adwords&hsa_ver=3&gad_source=1&gad_campaignid=21549710781&gbraid=0AAAAADBZOyHNJGliaXWCHw3zcL2rLuBia&gclid=Cj0KCQjw1ZjOBhCmARIsADDuFTAOrew1ryVA7mRF4TaXuzpBewFISzV3c49LxzVOq_qw9pA6lQVG_oIaAlqREALw_wcB](https://www.furnishedfinder.com/?utm_source=google&utm_medium=cpc&utm_campaign=Search+-+Tenants+-+V2&utm_content=Short+Term&utm_term=flat%20for%20short%20term%20rent&hsa_acc=7554573980&hsa_cam=21549710781&hsa_grp=166237664872&hsa_ad=708336038101&hsa_src=g&hsa_tgt=aud-2448728299609:kwd-1655286797901&hsa_kw=flat%20for%20short%20term%20rent&hsa_mt=p&hsa_net=adwords&hsa_ver=3&gad_source=1&gad_campaignid=21549710781&gbraid=0AAAAADBZOyHNJGliaXWCHw3zcL2rLuBia&gclid=Cj0KCQjw1ZjOBhCmARIsADDuFTAOrew1ryVA7mRF4TaXuzpBewFISzV3c49LxzVOq_qw9pA6lQVG_oIaAlqREALw_wcB) | **Docs:** [parse.bot/marketplace/8b5bd08e-cdf5-4f75-9ea4-15ecb6b6f3c4/furnishedfinder-com-api](https://parse.bot/marketplace/8b5bd08e-cdf5-4f75-9ea4-15ecb6b6f3c4/furnishedfinder-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-furnishedfinder-com-api-8b5bd08e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_details

Get full details for a single rental listing by its listing_id (from search_rentals results). Returns comprehensive property information including full description, all photos with captions, landlord info, amenities, bedrooms/bathrooms detail, fees, house rules, availability, coordinates, and nearby points of interest. Makes one request to the property detail page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | Listing ID from search_rentals (e.g. '1017765_1') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-furnishedfinder-com-api-8b5bd08e/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>"}'
```

### search_locations

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Location search text (city, state, address, or landmark name) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-furnishedfinder-com-api-8b5bd08e/search_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_rentals

Search for furnished rental listings by location with pagination. Returns listings with property details, pricing, availability, amenities, photos, and location data. Use search_locations first to get the encoded location ID. Supports filtering by price range, bedrooms, bathrooms, and property type. Pagination is page-based with configurable page size (max 72).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bathrooms` | string | No | Number of bathrooms filter (e.g. "1", "2") |
| `bedrooms` | string | No | Number of bedrooms filter (e.g. "1", "2", "3") |
| `location` | string | No | Encoded location ID from search_locations endpoint (e.g. us--ca--san-francisco--gp_ChIJIQBpAG2ahYAR_6128GcTUEo) |
| `max_price` | integer | No | Maximum monthly rent in USD |
| `min_price` | integer | No | Minimum monthly rent in USD |
| `ne_lat` | number | No | Northeast latitude of map viewport bounding box |
| `ne_lon` | number | No | Northeast longitude of map viewport bounding box |
| `page` | integer | No | Page number (1-based) |
| `page_size` | integer | No | Results per page (max 72, values above 72 are clamped) |
| `property_type` | string | No | Property type filter. Accepted values include Apartment, House, Condo, Room. |
| `sw_lat` | number | No | Southwest latitude of map viewport bounding box |
| `sw_lon` | number | No | Southwest longitude of map viewport bounding box |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-furnishedfinder-com-api-8b5bd08e/search_rentals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bathrooms":"<string>","bedrooms":"<string>","location":"<string>","max_price":"<integer>","min_price":"<integer>","ne_lat":"<number>","ne_lon":"<number>","page":"<integer>","page_size":"<integer>","property_type":"<string>","sw_lat":"<number>","sw_lon":"<number>"}'
```