API access
Integrate forensic video analysis into your applications with the ClipForensics API.
Overview
Programmatic video forensics
Submit videos, retrieve forensic reports, and integrate authenticity analysis into your workflows.
REST API
Simple HTTP endpoints for video submission, status polling, and result retrieval. JSON responses with full forensic data.
Async processing
Submit a video and receive a job ID. Poll for status or configure a webhook to be notified when analysis is complete.
Full forensic data
API responses include the same comprehensive data as the web interface: trust score, per-module breakdowns, evidence timeline, and compression history.
Batch processing
Submit multiple videos for analysis. Track progress and retrieve results for each video independently.
Quick Start
Example API usage
POST /api/v1/analyze
Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY
{
"file": <video_file>,
"options": {
"modules": "all",
"include_timeline": true,
"include_compression_history": true
}
}
// Response
{
"job_id": "job_abc123",
"status": "processing",
"estimated_time": 45
}GET /api/v1/results/job_abc123
Authorization: Bearer YOUR_API_KEY
// Response
{
"status": "complete",
"verdict": "likely_authentic",
"trust_score": 0.82,
"confidence": 0.91,
"modules": { ... },
"evidence_timeline": [ ... ],
"compression_history": { ... }
}Use Cases
Who uses the API
Content moderation platforms: Automatically screen user-uploaded videos for manipulation before publishing.
News organizations: Integrate forensic analysis into editorial workflow tools and CMS systems.
Research institutions: Batch-analyze video datasets for manipulation studies and benchmark evaluations.
Legal tech: Automate forensic documentation for video evidence in case management systems.