What is Data Access
Data Access lets you read your booking and revenue data programmatically, through a simple key-based REST API, with no AI tool involved. It’s useful if you want to feed your own dashboards, spreadsheets, or internal tools with your data.Looking to connect an AI tool (Claude, ChatGPT, Grok) so you can ask questions about your data
in plain language? See the “Etherly Insights” guide.
Data Access is strictly read-only. No call can create, modify, or delete data.
Guest privacy
Guest personal details are never returned: name, email, phone, and identification number never appear in the results. Only non-identifying fields are allowed (nights, amounts, booking channel, and guest country of origin — derived from the phone’s country code, not actual nationality).Enabling it
1
Go to settings
Go to Settings → Advanced and find the “Data access (API)” section.
2
Enable the feature
Click “Enable”.
3
Create an API key
Click “New key”, give it a label (e.g. “Internal dashboard”), and click “Create”.
Connecting your application
In the same section you’ll find:
Use your key as a Bearer token in the
Authorization header:
Available tools
The same tools as Etherly Insights — each endpoint corresponds to one tool.Revenue & performance
Pricing & occupancy
Rankings & comparisons
Bookings & guests
Operations
Local market
Market tools rely on an external market-data source and have a daily usage allowance per account.
Advisor
Usage limits
- Daily limit: up to 500 calls/day in total across all your keys combined.
- A per-minute rate limit also applies for security reasons.
Revoking access
- To revoke a specific API key, click the delete icon next to it in the list.
- To fully disable Data Access, click “Disable” — all active keys are revoked immediately.
Revocation takes effect immediately — there is no delay or cache that would let a revoked key keep working.