smart

Find a moment from a natural-language query (creates a clip)

AI search over the transcript; creates a new clip appended to the list and returns it. Requires a transcript (video ready). Free plan: 5 searches/day → 402 beyond.

post/api/videos/{id}/search

Request

  • Base URL: https://cliponit.app
  • URL: https://cliponit.app/api/videos/{id}/search
  • Auth: one of:
    • HTTP bearer
    • API key in cookie session
    • OAuth 2 (authorization code, authorization URL https://cliponit.app/oauth/authorize, token URL https://cliponit.app/oauth/token, scopes: clips)

Path parameters

idstring uuid required
Example:6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90

Video id (UUID)

Request body

querystring required

Example request

{
  "query": "the part about pricing"
}

Response

New clip

idstring uuid required
video_idstring uuid required
positioninteger required

Chronological order

titlestring required
start_snumber required

Absolute start in the source video (seconds)

end_snumber required

Absolute end (seconds)

created_atstring required
scoreinteger nullable

Estimated viral potential (AI)

reasonstring nullable

One sentence explaining the score, in the transcript language

descriptionstring nullable

Ready-to-post caption (null until describeClip)

hashtagsstring[] nullable

Without #

thumbnail_urlstring nullable

/files/thumbs/clips/<clip_id>.jpg, 320 px frame at start_s + 1

Example response

{
  "id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90",
  "video_id": "6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90"
}

Changes

No recorded changes to this operation across all 1 revision of this API.