Media API: Detect scenes in a video

Returns the cut list for one video URL: start, end and duration per scene, plus a measured motion score and its class. Use it with a transcript to see which claim lands on which shot.

5 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url*string

Public http(s) URL of one video or audio file. Ad-library creative URLs expire — fetch the ad and analyse it in the same run.

Formaturi

Lengthlength <= 4096

proxy_tier?string

Connection tier used to download the media file. none uses a direct connection.

Default"none"

Value in

"none"
"datacenter"
"residential"

threshold?number

Cut sensitivity. Lower finds more cuts; 27 is the detector's default and suits fast-cut ad creative.

Range5 <= value <= 100

Default27

curl -X POST "https://example.com/v1/media/scenes" \  -H "x-api-key: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "url": "https://video.example.com/creative.mp4"  }'

{  "data": {    "scene_count": 0,    "scenes": [      {        "index": 0,        "start": 0,        "end": 0,        "duration": 0,        "motion_score": 0,        "motion": "static"      }    ],    "fps": 0,    "duration": 0,    "threshold": 0,    "media": {      "bytes": 0,      "content_type": "string",      "container": "string",      "width": 0,      "height": 0,      "has_audio": true,      "has_video": true    },    "timing": {      "total_seconds": 0,      "compute_seconds": 0    },    "limits": {      "max_duration_s": 0,      "max_bytes": 0    }  }}