Butlr is a privacy-first people-sensing platform that combines advanced hardware and software to deliver anonymous occupancy data, helping organizations understand how people interact within a space. At its core is the Heatic™ sensor, which uses thermal technology to capture occupancy data while ensuring privacy. This data can be seamlessly integrated into various applications through Butlr's APIs, enabling organizations across industries like workplace, healthcare, and retail to optimize space utilization, improve operational efficiency, and create tailored solutions.
Heatic™ Sensor
The Butlr Heatic™ sensor is a first-of-its-kind wireless device that uses thermal sensing technology to detect occupancy and human presence indoors. Unlike cameras, the Heatic™ sensor is built with a privacy-first approach, detecting body temperature and determining presence without capturing any visual images. By gathering surface temperature data and leveraging advanced machine learning models, it accurately infers human activity without ever collecting Personal Identifiable Information (PII).
The sensors form a mesh network with constant data relays to the Hive. The Hive is the central node, sending thermal data to the cloud through Wi-Fi, cellular, or Ethernet. Once in the cloud, our algorithms process the raw data into occupancy detections. These detections are accessible through Butlr's APIs for integration into your systems, or you can monitor and analyze them directly through the Butlr web application.
Butlr Developer Tools
Butlr's public APIs are the same ones we use internally to develop our applications. We currently offer a GraphQL API for querying asset data and a REST API for reporting time-series occupancy data. These APIs provide powerful tools for accessing and integrating detailed spatial and occupancy data into your own systems, ensuring consistency and reliability across all applications built on the Butlr platform.
GraphQL API
The Butlr GraphQL API is designed for asset data management, enabling querying and mutating specific details about assets such as buildings, floors, rooms, sensors, and hives. It’s beneficial for developers who need customized queries and mutations to build tailored applications or integrate data into existing systems. The API provides fine-grained control over the data you request, making it ideal for scenarios where you need specific information and the ability to manipulate data efficiently.
querySampleQuerySensors { sensors { data { client_id floor_id room_id hive_id hive_serial sensor_id name mac_address mode model sensitivity center height orientation field_of_view } }}
querySampleQueryHives { hives { data { client_id floor_id room_id hive_id serial_number name } }}
querySampleQueryZones { zones { data { client_id floor_id room_id zone_id coordinates name } }}
querySampleQueryRooms { rooms { data { client_id floor_id room_id coordinates name } }}
querySampleQueryFloors { floors { data { client_id building_id floor_id name } }}
querySampleQueryBuildings { buildings { data { id name } }}
querySampleQuerySites { sites { data { id name timezone } }}
Reporting API
The Butlr Reporting APIis a REST API focused on delivering time-series occupancy data, making it suitable for analyzing trends in space utilization. This API is best used for standardized reporting, where aggregated data is needed to manage and optimize physical spaces. Use this API to track occupancy patterns over time or analyze historical trends, enabling data-driven decisions that enhance space management strategies.
{"window": {"every":"1h","function":"max","timezone":"America/New_York"//replace with your timezone },"filter": {"start":"2024-01-01T04:00:00Z",//start of the day in timezone"stop":"2024-01-02T04:00:00Z",//current time"measurements": ["floor_occupancy"],"spaces": {"eq": ["space_XXXX"] //floor(s) you are interested in } }}
{"window": {"every":"1h","function":"max","timezone":"America/New_York"//replace with your timezone },"filter": {"start":"2024-01-01T04:00:00Z",//start of the day in timezone"stop":"2024-01-02T04:00:00Z",//current time"measurements": ["room_occupancy"],"rooms": {"eq": ["room_XXXX"] //rooms(s) you are interested in } }}
{"window": {"every":"1h","function":"max","timezone":"America/New_York"//replace with your timezone },"filter": {"start":"2024-01-01T04:00:00Z",//start of the day in timezone"stop":"2024-01-02T04:00:00Z",//current time"measurements": ["traffic_floor_occupancy"],"spaces": {"eq": ["space_XXXX"] //floor(s) you are interested in } }}
{"window": {"every":"1h","function":"max","timezone":"America/New_York"//replace with your timezone },"filter": {"start":"2024-01-01T04:00:00Z",//start of the day in timezone"stop":"2024-01-02T04:00:00Z",//current time"measurements": ["traffic_room_occupancy"],"rooms": {"eq": ["room_XXXX"] //room(s) you are interested in } }}
Webhook
The Butlr Webhooks are event-triggered mechanisms that enable real-time data delivery to external systems. When specific events occur—such as changes in occupancy or sensor activity—webhooks automatically send relevant data to pre-configured endpoints. This allows seamless integration and instant updates, ensuring your systems stay synchronized without manual polling.
