Skip to main content
GET
/
video-detections
/
{content_id}
{
  "content_id": "<string>",
  "total_detections": 123,
  "detections": [
    {
      "id": "<string>",
      "type": "<string>",
      "label": "<string>",
      "confidence": 123,
      "timestamp": 123,
      "duration": 123,
      "bounding_box": {
        "x": 123,
        "y": 123,
        "width": 123,
        "height": 123
      },
      "attributes": {}
    }
  ],
  "processing_metadata": {
    "processed_at": {},
    "processing_duration": 123,
    "video_duration": 123,
    "resolution": {
      "width": 123,
      "height": 123
    }
  }
}

Overview

Retrieves detection results for video content, including objects, faces, text, and other visual elements that have been detected and analyzed in the video.

Path Parameters

content_id
string
required
Unique identifier of the video content

Query Parameters

detection_type
string
Filter by specific detection type
  • objects - Object detection results
  • faces - Face detection results
  • text - Text detection results
  • scenes - Scene detection results
confidence_threshold
number
default:"0.7"
Minimum confidence score for detections (0.0 to 1.0)
limit
integer
default:"100"
Maximum number of detections to return
offset
integer
default:"0"
Number of detections to skip for pagination

Response

content_id
string
required
ID of the analyzed video content
total_detections
integer
required
Total number of detections found
detections
array
required
List of detection results
processing_metadata
object
Processing information

Examples

curl -X GET "https://api.judge.example.com/video-detections/cnt_video123?detection_type=objects&confidence_threshold=0.8&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://api.judge.example.com/video-detections/invalid_content" \
  -H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://api.judge.example.com/video-detections/cnt_processing123" \
  -H "Authorization: Bearer YOUR_API_KEY"