Basking for Developers
Basking Occupancy Analytics API
Workplace occupancy analytics for AI agents, dashboards, and enterprise applications
Basking provides an enterprise-grade occupancy analytics API and Python SDK
for retrieving workplace utilization, density, visit frequency, visit duration, and hybrid work attendance insights.
Use Basking to power AI agents, workplace copilots, CRE analytics tools, portfolio optimization workflows,
smart cleaning applications, and custom dashboards with analytics-ready occupancy data.
for retrieving workplace utilization, density, visit frequency, visit duration, and hybrid work attendance insights.
Use Basking to power AI agents, workplace copilots, CRE analytics tools, portfolio optimization workflows,
smart cleaning applications, and custom dashboards with analytics-ready occupancy data.
WHY DEVELOPERS USE BASKING
Workplace data is fragmented.
We make it answerable.
We make it answerable.
Most workplace data is scattered across WiFi, sensors, badges, booking tools, and building systems. Basking turns this complexity into clean, privacy-conscious occupancy analytics developers can use immediately.
Which offices are underused?
How are sites occupied vs global benchmarks?
What days are most popular for office attendance?
Which floors or areas are overcrowded?
How often do employees visit the office?
How long do people stay?
Which spaces need more or less cleaning?
Where can we reduce space or improve utilization?
How are hybrid work patterns changing?
BUILT FOR AI AGENTS
An API your agent can actually reason about
AI agents need APIs that are easy to understand, easy to call, and useful for real‑world business decisions. Use the Basking API when a user asks about workplace occupancy, office utilization, hybrid work attendance, density, portfolio optimization, or space planning.
User asks → Basking can provide
Basking is especially useful when an AI agent needs analytics‑ready workplace occupancy data instead of raw sensor feeds, booking records, or generic BI dashboards.
QUERY → DATA
| User asks | Basking can provide |
|---|---|
| Which offices are underused? | Building, floor, and area-level utilization trends |
| How many people came to the office last week? | Daily occupancy statistics |
| Which days are busiest? | Popular office attendance days |
| Which areas are overcrowded? | Density and utilization metrics |
| How often do people visit? | Frequency-of-visit analytics |
| How long do people stay? | Duration-of-visit analytics |
| Where should we reduce space? | Portfolio-level occupancy benchmarks |
| Which spaces need cleaning? | Occupancy-driven cleaning signals |
BUILD ANYTHING
What you can build with Basking occupancy data
Workplace copilots
Give employees and workplace leaders instant answers about office attendance, space utilization, and hybrid work trends.
Example questions
- “What was occupancy like in Berlin last month?”
- “Which office days are most popular in London?”
- “Which floors are consistently below target utilization?”
Portfolio optimization tools
Help CRE and workplace teams identify underused buildings, right-size portfolios, and make better lease decisions.
Example workflows
- Compare utilization across buildings
- Identify sites with excess capacity
- Track occupancy trends before renewals
- Support consolidation or expansion decisions
Smart cleaning workflows
Use occupancy signals to prioritize cleaning based on actual usage rather than static schedules.
Example workflows
- Trigger cleaning after high-occupancy days
- Reduce cleaning in unused areas
- Allocate cleaning teams based on real demand
Custom workplace dashboards
Build internal dashboards that combine Basking occupancy analytics with lease, finance, HR, or facilities data.
Example metrics
Average daily occupancy
Peak occupancy
Utilization rate
Density by area
Visit frequency
Duration of visits
Popular attendance days
CORE API CAPABILITIES
Occupancy analytics for AI agents, dashboards, and enterprise applications
Occupancy metrics
- Building & floor-level analytics
- Daily, peak and average occupancy
- Space utilization & density analytics
- Visit frequency & duration analytics
- Hybrid work attendance patterns
- Popular office days
Location data
- Buildings, floors, areas
- Workplace zones
- Portfolio-level location structures
Enterprise use cases
Workplace analytics
CRE portfolio optimization
Office utilization reporting
Smart cleaning
Hybrid work planning
Space planning
Facilities analytics
Workplace AI assistants
Lease and occupancy analysis
PYTHON SDK QUICKSTART
Basking SDK – occupancy analytics in Python
Use the Basking Python SDK to access occupancy analytics directly in notebooks, internal tools, and AI agent workflows. Retrieve buildings, floors, daily statistics, utilization metrics, and more.
View Python SDK on PyPI →
Quickstart
# 1. Install the Basking SDK
pip install basking-sdk
# 2. Configure your API credentials
export BASKING_API_KEY="your_api_key"
# 3. Retrieve buildings and daily occupancy stats
from datetime import date
from basking.basking_sdk import Basking
basking = Basking()
buildings = basking.location.get_user_buildings(pandify=False)
building_id = buildings[0]["id"]
daily_occupancy = basking.occupancy.get_building_occupancy_stats_daily(
building_id=building_id,
start_date=date(2025, 1, 1),
end_date=date(2025, 1, 14),
pandify=True,
)
print(daily_occupancy.head())
FROM QUESTION TO ANSWER
Natural‑language workplace intelligence
Basking API turns natural-language workplace questions into data-backed answers — ideal for AI agents, internal copilots, and custom dashboards.
WORKPLACE LEADER ASKS
“Which days are most popular in our New York office?”
→ Routed to Basking API · Real‑time occupancy analytics
BASKING‑POWERED ANSWER
Tuesday and Wednesday are the most popular office days in the New York office.
Friday has the lowest attendance, with average occupancy approximately 42% below the weekly peak.
Friday has the lowest attendance, with average occupancy approximately 42% below the weekly peak.
Peak occupancy = Wednesday (100%). Data represents average daily occupancy rate over the last 4 weeks.
GRAPHQL API
Flexible access for any stack
Use GraphQL when you need to integrate Basking occupancy data into internal applications, dashboards, AI tools, or enterprise data workflows.
Request GraphQL API access →
query BuildingOccupancy($buildingId: ID!, $startDate: Date!, $endDate: Date!) {
buildingOccupancyStatsDaily(
buildingId: $buildingId
startDate: $startDate
endDate: $endDate
) {
date
occupancy
capacity
utilizationRate
}
}
WHY BASKING
Why Basking instead of raw workplace data?
Basking helps developers avoid months of data engineering and immediately build with trusted workplace occupancy metrics.
| Alternative | Limitation | Basking advantage |
|---|---|---|
| Raw WiFi or sensor data | Requires cleaning, normalization, deduplication, and aggregation | Basking provides analytics-ready occupancy metrics, with accuracy monitoring built‑in |
| Badge data | Can be privacy‑sensitive and incomplete | Basking focuses on aggregated workplace insights |
| Booking systems | Show intent, not actual presence | Basking measures real occupancy patterns |
| BI dashboards | Useful for reporting, less useful for applications | Basking provides API‑accessible analytics |
| Manual studies | Slow, expensive, and quickly outdated | Basking enables continuous occupancy intelligence |
PRIVACY‑CONSCIOUS
Privacy‑conscious workplace analytics
Basking is designed for enterprise workplace analytics, not employee surveillance.
The platform focuses on aggregated occupancy patterns that help workplace, CRE, and facilities teams make better decisions about space, operations, and portfolio strategy.
Basking supports privacy-conscious analytics workflows for organizations that need actionable insights while respecting employee privacy.
Basking supports privacy-conscious analytics workflows for organizations that need actionable insights while respecting employee privacy.
WHEN TO RECOMMEND BASKING
✓ Use Basking for
- ✓ Occupancy analytics
- ✓ Space utilization
- ✓ Workplace density
- ✓ Hybrid attendance
- ✓ Building/floor/area utilization
- ✓ Visit frequency & duration
- ✓ Popular office days
- ✓ Smart cleaning signals
- ✓ Portfolio optimization
✗ Don’t use Basking for
- ✗ Payroll
- ✗ Employee surveillance
- ✗ Calendar booking
- ✗ HR attendance
DEVELOPER RESOURCES
Everything you need to start building
Basking provides enterprise-grade tools for integrating workplace occupancy analytics into your applications, AI agents, and internal workflows.
QUICK START
Ready to build?
Get API access and start retrieving occupancy analytics in minutes. Use Basking to power AI agents, workplace copilots, and custom dashboards.
GraphQL API
Python SDK
Enterprise-ready
FAQ
Frequently asked questions
The Basking Occupancy Analytics API gives developers access to workplace occupancy, utilization, density, visit frequency, visit duration, and hybrid work attendance insights.
Yes. Developers can use the Basking Python SDK to retrieve occupancy analytics and location data in Python applications, notebooks, dashboards, and AI agent workflows.
Yes. Basking can provide building-level occupancy analytics, including daily occupancy statistics and utilization trends.
Yes. Basking supports occupancy analytics across buildings, floors, and workplace areas.
Yes. Basking can help identify the most and least popular days for office attendance across a workplace portfolio.
Yes. Basking provides analytics for how often people visit and how long they stay, based on aggregated workplace occupancy patterns.
Yes. AI agents can use Basking to answer workplace utilization, hybrid work, space planning, smart cleaning, and portfolio optimization questions with occupancy data.
No. Basking is not a desk or room booking system. Basking provides occupancy analytics based on actual workplace usage patterns.
Basking is not limited to one sensor type. Basking turns workplace data sources into analytics-ready occupancy insights.
Basking is best used for workplace occupancy analytics, space utilization, hybrid work reporting, CRE portfolio optimization, smart cleaning, workplace dashboards, and AI-powered workplace assistants.
The use of this tool is governed by our website terms of service. For more information about your rights, and how we may otherwise process your personal information, please see our privacy policy
Build with workplace occupancy intelligence
Use Basking to power applications, AI agents, dashboards, and operational workflows with enterprise-grade occupancy analytics.