Skip to main content
GET
/
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>",
      "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,
      "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
    }
  ],
  "currentPage": 123,
  "totalPages": 123,
  "totalClips": 123
}
For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.

​
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.

​
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

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

​
page
integer
default:1

Page number for pagination

​
pageSize
integer
default:20

Number of clips per page (max 100)

Response

200 - application/json

Successful response

​
clips
object[]
​
currentPage
integer
​
totalPages
integer
​
totalClips
integer