Complete API documentation for integrating with Perimi's video intelligence platform
HTTP-based API for direct integration with any programming language
Official Python library with full API coverage and utilities
Browser and Node.js compatible SDK for web applications
Generate an API key from your dashboard settings
Dashboard → Settings → API Keys → Generate New KeyInclude your API key in the Authorization header
Authorization: Bearer YOUR_API_KEYStart making API calls to manage streams and get data
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.perimi.ai/v1/streamsKey concepts to understand before using the API
Streams represent video feeds from cameras or other sources. Each stream has a unique ID and can be configured with detection zones and alert settings.
GET /v1/streams/{stream_id}Anomalies are detected events in video streams. They include confidence scores, timestamps, and metadata about what was detected.
GET /v1/anomalies?stream_id={id}All API requests require authentication using Bearer tokens. API keys can be generated from your dashboard.
Authorization: Bearer {API_KEY}API requests are rate limited per API key. Check response headers for current limit status and reset times.
X-RateLimit-Remaining: 100Choose your preferred integration method and start building with Perimi