Kitcast API Integration Guide
The Kitcast API allows you to manage your Digital Signage network programmatically. It’s a RESTful interface that helps you automate device management, content scheduling, and playlist updates — and even integrate Kitcast with other business systems like CRMs or ERPs.
Think of it as a way to “talk” to Kitcast from your own software, without using the dashboard manually.
1. How It Works
-
Base URL:
https://api.next.kitcast.tv/api/v1 -
Data Format: JSON for both requests and responses
-
HTTP Methods: Standard GET, POST, PUT, DELETE
2. Authentication
-
All API calls require an API token.
-
The token goes in the header of every request:
Authorization: Bearer <YOUR_API_TOKEN> -
You can generate or retrieve your token in the Kitcast Dashboard under Integration Settings.
3. Core Features
Here are the main things you can do with the API:
A. Devices
-
See all connected devices (Apple TV, Android players, etc.)
-
Get device info: online status, current content, app version
-
Update device settings (rename, assign to location)
B. Playlists
-
Create, modify, or delete playlists
-
Control content order, loops, and scheduling
C. Media Assets
-
Upload images or videos programmatically
-
Organize your media library for playback
D. Locations & Groups
-
Organize your screens in groups or by location
-
Assign playlists in bulk across multiple devices
4. Error Handling
The API uses standard HTTP response codes:
-
200 OK– Request successful -
401 Unauthorized– Invalid token -
403 Forbidden– Insufficient permissions -
404 Not Found– Resource doesn’t exist -
422 Unprocessable Entity– Data validation error
5. Common Use Cases
-
Dynamic Updates: Change menu boards or office screens automatically from internal data
-
Health Monitoring: Track screen status across multiple locations
-
Emergency Alerts: Push urgent content or safety messages instantly
6. Learn More
For full technical details, JSON schemas, and interactive testing, visit the official API documentation:
Kitcast API Documentation