Quickstart
This page walks you through your first request to Staying API.
1. Sign up
Create an account. You get 100 free credits and no card is required.
2. Create an API key
From the dashboard, go to API keys and click Create key. The full secret is shown exactly once — copy it into your password manager before clicking dismiss.
API keys look like sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (32 base64url
characters after the prefix).
3. Make your first call
curl https://api.stayingapi.com/v1/stays/1135700964697993602 \ -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"import httpx
r = httpx.get( "https://api.stayingapi.com/v1/stays/1135700964697993602", headers={"Authorization": "Bearer sk_live_..."}, timeout=30,)r.raise_for_status()print(r.json())You should see a JSON response shaped like this:
{ "data": { "id": "1135700964697993602", "title": "Beachfront flat in Estoril", "pricing": { "price": 184, "currency": "USD" }, "host": { "is_superhost": true } }, "request_id": "req_..."}4. Search for stays
curl -X POST https://api.stayingapi.com/v1/search \ -H "Authorization: Bearer sk_live_..." \ -H "content-type: application/json" \ -d '{"location":"Lisbon, Portugal","filters":{"minBeds":2,"priceMax":250}}'What to read next
- Authentication — bearer + OAuth.
- Errors — every error code we emit.
- Stays endpoint — fields, sub-resources, projections.
- Search endpoint — filters and pagination.