Skip to main content
The Video Analysis API enables you to analyze uploaded videos for potential AI-generated or manipulated content.
This endpoint is designed for scenarios such as identity verification, remote onboarding, or media authenticity checks. Each analysis produces structured results that indicate whether the media contains signs of synthetic generation, tampering, or composited elements.

​
How it works

  1. Upload your video to a publicly accessible or pre-signed URL.
  2. Call the Dataspike Deepfake API endpoint with the video reference and optional applicant context.
  3. The system performs frame sampling and authenticity analysis.
  4. A structured response is returned containing the detection status, confidence scores, and indicators.

​
Example request

curl -X POST "https://api.dataspike.io/api/v4/deepfake/video/analyze" \
  -H "ds-api-token: $API_KEY" \
  -F "file=@/path/to/video.mp4"

​
Example response

{
  "id": "01827ed4-c928-7a3c-9a30-7ab7cc169d11",
  "status": "completed",
  "job_type": "video",
  "content_type": "video/mp4",
  "file_size_bytes": 73400320,
  "score": 0.985,
  "verdict": "deepfake_unlikely",
  "sandbox": false
}

​
Recommendations

The Video Analysis API is optimized for person-centric recordings, such as liveness checks, selfie videos, or short clips from video calls.
It is not intended for generic or mixed-content footage.
  • Content type — Use videos showing a single visible person, captured from a front-facing camera in natural lighting.
    Avoid compilations, crowd scenes, or edited footage.
  • Duration — Short clips of 15–30 seconds are ideal. Longer videos do not improve detection accuracy and may reduce clarity if they contain multiple contexts or transitions.
  • File size — Keep uploads under 100 MB to ensure smooth transmission and faster processing.
  • Format — Prefer MP4 (H.264) or WebM for compatibility.
  • Environment — Steady camera position, minimal background movement, and clear facial visibility yield the most consistent results.
  • Testing — Always validate your upload and analysis flow in the Sandbox environment before switching to production.
These guidelines help the system extract reliable visual and biometric cues, enabling faster and more accurate authenticity analysis.
For full parameter details and supported media types, see the API Reference.