# Staying API
> REST API for Airbnb stay data. Canonical Stay shape: id, url, title, description,
> property_type, room_type, person_capacity, star_rating, location, host, pricing,
> reviews_count, rating_breakdown, photos, reviews, amenities, availability.
> Field availability: nightly `pricing` is populated on the dated /v1/search path,
> not on single-listing detail lookups; `reviews[]` bodies, `rating_breakdown`,
> `room_type`, and `property_type` are not currently provided by the upstream
> source and come back null/empty (use `reviews_count` and `star_rating`);
> `location.city`/`country` are derived from the search query on /v1/search.

## Auth
- Header: `Authorization: Bearer sk_<32 base64url>`
- Signup: https://stayingapi.com/signup (100 free credits, no card)

## Pricing
- Free: 100 credits one-time
- Monthly: $5/mo, 400 credits, top-ups $15/1k
- Annual: $54/yr, 5000 credits, top-ups $12/1k

## Integration
- MCP server: https://api.stayingapi.com/mcp (OAuth + bearer)
- OpenAPI 3.1: https://stayingapi.com/openapi.json
- Agent skills: https://stayingapi.com/.well-known/agent-skills/index.json
- Full docs (concatenated): https://stayingapi.com/llms-full.txt

## Docs
- /quickstart
- /authentication
- /errors
- /rate-limits
- /pagination
- /output-formats
- /field-projection
- /async-jobs
- /webhooks-guide
- /ai-agents

## API reference
- /api/stay
- /api/listings
- /api/search
- /api/jobs
- /api/webhooks
- /api/account

## Recipes
- /recipes/full-stay
- /recipes/search-then-detail
- /recipes/verify-webhook

## Legal
- /legal/trademark-and-affiliation