Find the best clips in an analysed video

The best self-contained reels in an analysed video, ranked 0-100, each with snapped cut points (start on a sentence start with a short head; end on a sentence end with a 0.45 s tail past the last word

), the hook line, a cold-open suggestion when the strongest line is not the first, the transcript, the signals and the reasons. Needs a ready analysis with a speech transcript. A transparent heuristic, not a view prediction. Free; CPU, seconds.

Authorization

bearerAuth

AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Path Parameters

analysisId*string

Formatuuid

Query Parameters

count?integer

How many clips (default 5).

Range1 <= value <= 20

min_sec?number

Shortest clip, seconds (default 25).

Range5 <= value <= 180

max_sec?number

Longest clip, seconds (default 60).

Range10 <= value <= 300

Response Body

`application/json`

curl -X GET "https://example.com/video-analyses/497f6eca-6276-4993-bfeb-53cbbbba6f08/clips"

{
  "data": {
    "analysis_id": "string",
    "source_duration_sec": 0,
    "words_used": 0,
    "note": "string",
    "clips": [
      {
        "start": 0,
        "end": 0,
        "firstWord": 0,
        "lastWord": 0,
        "durationSec": 0,
        "score": 0,
        "hook": "string",
        "text": "string",
        "coldOpen": {
          "start": 0,
          "end": 0,
          "text": "string"
        },
        "reasons": [
          "string"
        ]
      }
    ]
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

Find the best clips in an analysed video

Authorization

Path Parameters

Query Parameters

Response Body

200application/json

400application/json

401application/json

404application/json

409application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`