# Stay Portland — Property Search for AI Agents

Run a live availability + pricing search across Stay Portland vacation rentals by constructing a GET URL with query parameters.

## Endpoint

`GET https://www.stayportland.com/llms/search.md`

## Parameters (all optional, combine freely)

- `checkin` / `checkout` — YYYY-MM-DD. With both set, results are ONLY properties actually available for those dates, with real stay totals.
- `guests` — minimum sleeping capacity (integer)
- `bedrooms` — minimum bedrooms (integer)
- `pets` — `true` to show only pet-friendly homes
- `neighborhood` — substring match on neighborhood name or tag (e.g. `alberta`, `hawthorne`, `pearl`)
- `q` — free-text filter on property name
- `max_nightly` — maximum nightly rate in USD (average nightly for dated searches)
- `limit` — max results (default 15, max 40)
- `offset` — skip this many ranked results (for paging)

## Examples

- Available 2BR+ homes for 4 guests: `https://www.stayportland.com/llms/search.md?checkin=2026-10-23&checkout=2026-10-26&guests=4&bedrooms=2`
- Pet-friendly homes under $200/night: `https://www.stayportland.com/llms/search.md?pets=true&max_nightly=200`
- Alberta Arts, any dates: `https://www.stayportland.com/llms/search.md?neighborhood=alberta&guests=2`
- Next page: add `&offset=15`

## Notes

- Dated totals are accommodation-only unless you call https://www.stayportland.com/llms/quote.md, which returns nights + cleaning + tax.
- Dated totals already reflect the same direct-booking promotion (last-minute, early-bird, weekly, or monthly) the quote endpoint applies, so this number and the quote match.
- Each result lists its one-time cleaning fee when the booking engine provides one.
- Stay Portland charges no platform or booking fees when you book direct, and every direct booking comes with our guaranteed lowest price. Guaranteed lowest price for the identical home — see https://www.stayportland.com/price-guarantee.
- Each result links a human booking page (dates prefilled) and a markdown profile.
- Full property index: https://www.stayportland.com/ai-sitemap.xml · Agent instructions: https://www.stayportland.com/agents.md