Skip to main content
GET
/
automation
/
get-clip-details
Get Clip Details
curl --request GET \
  --url https://public.reap.video/api/v1/automation/get-clip-details \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "projectId": "<string>",
  "clipUrl": "<string>",
  "clipWithCaptionsUrl": "<string>",
  "startTime": 123,
  "endTime": 123,
  "duration": 123,
  "topic": "<string>",
  "title": "<string>",
  "caption": "<string>",
  "language": "<string>",
  "translateTranscription": true,
  "translationLanguages": [
    "<string>"
  ],
  "transcriptionScript": "native",
  "viralityScore": 123,
  "reframeClips": true,
  "exportResolution": 123,
  "exportOrientation": "landscape",
  "captionsPreset": "<string>",
  "enableCaptions": true,
  "enableEmojis": true,
  "enableHighlights": true,
  "metadata": {
    "width": 123,
    "height": 123,
    "aspectRatio": "<string>",
    "size": 123,
    "bitrate": 123,
    "fps": 123,
    "duration": 123,
    "rotation": 123,
    "resolution": 123,
    "codec": "<string>",
    "codecFullName": "<string>",
    "codecTag": "<string>",
    "format": "<string>",
    "formatFullName": "<string>"
  },
  "createdAt": 123,
  "updatedAt": 123
}

Overview

Get detailed information about a specific clip, including its download URL, AI-generated metadata, virality score, and export settings.

Rate Limiting

This endpoint is rate limited to 10 requests per minute per API key.

Response

id
string
Unique identifier for the clip
projectId
string
ID of the parent project
clipUrl
string
Direct download URL for the final clip (includes captions if enabled)
clipWithCaptionsUrl
string
Deprecated. Use clipUrl instead, which now includes captions when enabled.
startTime
number
Start time of the clip in the original video (seconds)
endTime
number
End time of the clip in the original video (seconds)
duration
number
Duration of the clip in seconds
topic
string
Primary topic or theme of the clip
title
string
AI-generated title for the clip
caption
string
AI-generated caption/description for the clip
language
string
Language of the clip content
translateTranscription
boolean
Whether transcription is translated
translationLanguages
array
Array of languages for translation
dubbingLanguage
string
Target dubbing language (for dubbing projects)
transcriptionScript
string
Script format for transcription (“native” or “roman”)
viralityScore
number
AI-predicted virality score (0-10, higher is better)
reframeClips
boolean
Whether this clip is reframed
exportResolution
integer
Resolution of the exported clip
exportOrientation
string
Orientation of the exported clip (“landscape”, “portrait”, “square”)
captionsPreset
string
Caption style preset used for this clip
enableCaptions
boolean
Whether captions are enabled for this clip
enableEmojis
boolean
Whether emojis are added to captions
enableHighlights
boolean
Whether keyword highlighting is enabled
metadata
object
Clip metadata including technical details
createdAt
integer
Unix timestamp when the clip was created
updatedAt
integer
Unix timestamp when the clip was last updated

Example Request

curl -X GET "https://public.reap.video/api/v1/automation/get-clip-details?projectId=65f1a2b3c4d5e6f7a8b9c0d2&clipId=65f1a2b3c4d5e6f7a8b9c0d4" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Example Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

projectId
string
required

Unique identifier of the project

clipId
string
required

Unique identifier of the clip

Response

200 - application/json

Successful response

id
string
projectId
string
clipUrl
string | null

Direct download URL for the final clip (includes captions if enabled)

clipWithCaptionsUrl
string | null
deprecated

Deprecated. Use clipUrl instead.

startTime
number
endTime
number
duration
number
topic
string | null
title
string | null
caption
string | null
language
string | null
translateTranscription
boolean
translationLanguages
string[]
transcriptionScript
enum<string>
default:native
Available options:
native,
roman
viralityScore
number | null
reframeClips
boolean
exportResolution
integer
exportOrientation
enum<string>
Available options:
landscape,
portrait,
square
captionsPreset
string | null
enableCaptions
boolean
enableEmojis
boolean
enableHighlights
boolean
metadata
object
createdAt
integer
updatedAt
integer