Skip to main content
Developer & Technical Integration

EchoDepth REST API

Integrate EchoDepth emotional signal analysis into your platform, workflow or application. REST endpoints for video, audio, text and image analysis. WebSocket for real-time streaming. Python and Node.js SDKs.

REST + WebSocket
Python & Node.js SDK
UK Data Residency
~700ms latency
API key auth

Authentication

EchoDepth API uses API key authentication. All requests must include your API key in the Authorization header. API keys are issued during commercial onboarding and scoped to your deployment context.

# HTTP header
Authorization: Bearer YOUR_API_KEY
# Base URL
https://api.echodepth.io/v1

Quick Start

# Python SDK
pip install echodepth
from
echodepth
import
EchoDepth
client = EchoDepth(api_key="YOUR_KEY")
result = client.analyse.video(
file="earnings_call.mp4"
)
print(result.trust_score)

API Endpoints

POST
/v1/analyse/video

Submit a video file or URL for full facial AU analysis. Returns Trust Score, Credibility Signal, Resistance Indicator and timestamped AU events.

POST
/v1/analyse/audio

Submit audio file or URL for vocal pattern analysis. Returns Confidence Score, Hesitation Map, Stress Indicators and timestamped vocal events.

POST
/v1/analyse/text

Submit a text string or document for linguistic emotional analysis. Returns Sentiment Depth, Engagement Signal, structural hesitation markers.

POST
/v1/analyse/image

Submit one or multiple images for facial expression analysis. Returns AU classification per face, VAD coordinates, Engagement Score.

POST
/v1/analyse/multimodal

Submit any combination of video, audio, text and image in a single request. Returns a unified Emotional Decision Intelligence report.

GET
/v1/result/{job_id}

Retrieve results for an async analysis job by job ID. Polling endpoint for long-form video and audio processing.

WS
/v1/stream/video

WebSocket connection for real-time video stream analysis. Returns per-frame AU classifications with sub-second latency.

Deployment options

Cloud (default)

Available now

Hosted by Cavefish. UK data residency. TLS 1.3. No data retained beyond processing. SOC2-pathway infrastructure.

On-premise

Enterprise

Full Docker deployment within your own infrastructure. Air-gap capable for defence and classified environments. SCIF-compatible.

Private cloud

Enterprise

Dedicated deployment in your cloud provider of choice (AWS, Azure, GCP). Isolated compute, UK region.

Request API access

API access is issued during commercial onboarding. Contact us to discuss your technical requirements, integration context and data architecture. We can provide a sandboxed test environment for technical evaluation before commercial commitment.

Request API Access →Security & compliance →