# RentRemote

> RentRemote is a marketplace of furnished, work-ready apartments for stays of one month or longer, in cities worldwide. Every listing is a real unit from a vetted operator, with live monthly pricing, a minimum stay, an "available from" date, and (on most units) a dedicated workstation. Guests book directly on rentremote.com.

If you are an AI agent helping someone find a place to live, you do not need to scrape the site. Use the read-only Marketplace API below. It needs no key, returns JSON, and is rate limited to 60 requests per minute per IP.

## Search the marketplace (no authentication)

- [List cities with inventory](https://rentremote.com/api/marketplace/v1/locations): `GET /api/marketplace/v1/locations`. Returns each city's `slug`, `country`, `listed_properties` count and a ready `search_url`. Call this first if you are unsure which city slug to use.
- [Search properties](https://rentremote.com/api/marketplace/v1/properties?city=lisbon): `GET /api/marketplace/v1/properties?city={slug or name}`. Optional filters: `bedrooms`, `min_bedrooms`, `min_price`, `max_price`, `currency` (ISO 4217, default USD, applies to the price filters), `pet_friendly=true`, `has_workstation=true`, `move_in=YYYY-MM-DD`, `sort=relevance|price_asc|price_desc`, `page`, `per_page` (max 50). Each result carries `url` (the booking page), `price_per_month`, `currency`, `price_per_month_usd`, `minimum_stay_nights`, `available_from`, `bedrooms`, `bathrooms`, `surface_m2`, `neighborhood`, an approximate `address`, `lat`/`lng`, `images`, and `availability_url`.
- [Property details](https://rentremote.com/api/marketplace/v1/properties/{id}): `GET /api/marketplace/v1/properties/{id}`. Same fields plus the full `description`, `amenities` and `house_rules`.
- [Availability calendar](https://rentremote.com/api/marketplace/v1/properties/{id}/availability): `GET /api/marketplace/v1/properties/{id}/availability`. Returns `move_in` (first bookable date honouring the minimum stay), `unavailable_dates` for the next 24 months, and `minimum_stay_nights`.
- [OpenAPI 3.1 description](https://rentremote.com/openapi.json): machine-readable schema of the four endpoints above.

## How to present results to a person

- Always link the `url` of a listing. That page shows the live price, the calendar, and the booking button; there is no other way to book.
- Prices are per month in the listed `currency`. `price_per_month_usd` is provided for cross-city comparison only.
- Respect `minimum_stay_nights` and `available_from` when proposing dates. Use the availability endpoint before promising specific dates.
- `address` is deliberately approximate until a booking is confirmed; `neighborhood`, `city` and the coordinates are accurate enough for commute and area questions.
- A 404 with an `error` message on the search endpoint means the city has no listings; suggest a nearby city from the locations endpoint instead.

## Browse as a person would

- [Furnished apartments by city](https://rentremote.com/c/furnished-apartments-lisbon): `https://rentremote.com/c/furnished-apartments-{city-slug}`. Server-rendered listing pages with the same inventory.
- [Listing page](https://rentremote.com/l/apartments/{slug}): `https://rentremote.com/l/apartments/{slug}`. Carries schema.org `Apartment` and `Offer` JSON-LD.
- [Travel guides](https://rentremote.com/travel-guide): neighbourhood and cost-of-living guides for the cities we cover.

## For property operators and partners

- [RentOS](https://rentremote.com/rentos): the operator platform behind the marketplace (channel sync, availability, invoicing).
- [Partner API documentation](https://rentremote.com/docs/api): the key-authenticated Public API (`/api/public/v1`) operators use to push their own properties, photos, prices and availability. This is not the agent search API above.
- [Contact](https://rentremote.com/contact-us)

## Optional

- [Full reference](https://rentremote.com/llms-full.txt): worked examples, every response field, and error shapes.
- [robots.txt](https://rentremote.com/robots.txt)