Skip to main content
GET
/
api
/
v1
/
automation
/
get-project-clips
Get Project Clips
curl --request GET \
  --url https://public.reap.video/api/v1/automation/get-project-clips \
  --header 'Authorization: Bearer <token>'
{
  "clips": [
    {
      "id": "<string>",
      "projectId": "<string>",
      "clipUrl": "<string>",
      "startTime": 123,
      "endTime": 123,
      "duration": 123,
      "topic": "<string>",
      "title": "<string>",
      "caption": "<string>",
      "language": "<string>",
      "translateTranscription": true,
      "translationLanguages": [
        {}
      ],
      "viralityScore": 123,
      "reframeClips": true,
      "exportResolution": 123,
      "exportOrientation": "<string>",
      "captionsPreset": "<string>",
      "enableCaptions": true,
      "enableEmojies": true,
      "enableHighlights": true,
      "metadata": {},
      "createdAt": 123,
      "updatedAt": 123
    }
  ],
  "currentPage": 123,
  "totalPages": 123,
  "totalClips": 123
}

​
Overview

Get all clips generated from a completed video project. This endpoint returns downloadable URLs for each clip, along with metadata like virality scores, titles, and captions.

​
Rate Limiting

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

​
Query Parameters

​
projectId
string
required
Unique identifier of the project
​
page
integer
default:"1"
Page number for pagination
​
pageSize
integer
default:"100"
Number of clips to return per page (maximum 100)

​
Response

​
clips
array
Array of clip objects
​
currentPage
integer
Current page number
​
totalPages
integer
Total number of pages available
​
totalClips
integer
Total number of clips in the project

​
Example Request

curl -X GET "https://public.reap.video/api/v1/automation/get-project-clips?projectId=65f1a2b3c4d5e6f7a8b9c0d2&page=1&pageSize=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Example Response

​
Virality Score

The virality score is an AI-predicted metric (0-10) that indicates how likely a clip is to perform well on social media:
  • 9-10: Exceptional content with viral potential
  • 7-8: High-quality content likely to perform well
  • 5-6: Good content suitable for regular posting
  • 3-4: Average content that may need optimization
  • 1-2: Lower-quality content requiring review

​
Clip Status

Clips are only returned when the parent project status is completed. If the project is still processing, this endpoint will return an empty clips array.

​
Use Cases

Content Distribution

Download clips for posting across social platforms

Performance Analysis

Use virality scores to prioritize high-potential content

Batch Processing

Retrieve all clips for automated publishing workflows

Quality Control

Review clip titles and captions before publishing
⌘I