Skip to content

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

Terminal window
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

Terminal window
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}}'