GET
/
api
/
v1
/
automation
/
get-project-details
Get Project Details
curl --request GET \
  --url https://public.reap.video/api/v1/automation/get-project-details \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "title": "<string>",
  "thumbnail": "<string>",
  "billedDuration": 123,
  "status": "<string>",
  "projectType": "<string>",
  "source": "<string>",
  "genre": "<string>",
  "topics": [
    {}
  ],
  "clipDurations": [
    {}
  ],
  "selectedStart": 123,
  "selectedEnd": 123,
  "reframeClips": true,
  "exportResolution": 123,
  "exportOrientation": "<string>",
  "captionsPreset": "<string>",
  "enableCaptions": true,
  "enableEmojies": true,
  "enableHighlights": true,
  "language": "<string>",
  "dubbingLanguage": "<string>",
  "translateTranscription": true,
  "translationLanguages": [
    {}
  ],
  "metadata": {},
  "urls": {},
  "createdAt": 123,
  "updatedAt": 123,
  "sourceVideo": "<string>",
  "videoFile": "<string>"
}

​
Overview

Get comprehensive information about a video project, including processing configuration, metadata, and current status. This endpoint returns the full project object with all settings and URLs.

​
Query Parameters

​
projectId
string
required
Unique identifier of the project to retrieve

​
Response

​
id
string
Unique project identifier
​
title
string
Project title (usually the filename or video title)
​
thumbnail
string
URL to the project thumbnail image
​
billedDuration
number
Duration in seconds that was billed to your account
​
status
string
Current processing status (“processing”, “completed”, “failed”, “cancelled”)
​
projectType
string
Type of project (“clipping”, “captions”, “reframe”, “dubbing”)
​
source
string
Source of the original video (“youtube”, “user_upload”, “external”)
​
genre
string
Video genre for AI analysis (“talking”, “educational”, “entertainment”, “business”)
​
topics
array
Array of topic strings identified in the video
​
clipDurations
array
Array of clip duration objects with min/max values
​
selectedStart
number
Start time in seconds for processing (null if entire video)
​
selectedEnd
number
End time in seconds for processing (null if entire video)
​
reframeClips
boolean
Whether clips are reframed for different aspect ratios
​
exportResolution
integer
Output resolution for clips (720, 1080, 1440, 2160)
​
exportOrientation
string
Output orientation (“landscape”, “portrait”, “square”)
​
captionsPreset
string
Caption style preset ID (null if captions disabled)
​
enableCaptions
boolean
Whether captions are enabled for this project
​
enableEmojies
boolean
Whether emojis are added to captions
​
enableHighlights
boolean
Whether keywords are highlighted in captions
​
language
string
Primary language of the video content
​
dubbingLanguage
string
Target language for dubbing projects
​
translateTranscription
boolean
Whether transcription is translated to other languages
​
translationLanguages
array
Array of language codes for translation
​
metadata
object
Video metadata including duration, resolution, format, etc.
​
urls
object
Object containing various project URLs and assets
​
createdAt
integer
Unix timestamp when the project was created
​
updatedAt
integer
Unix timestamp when the project was last updated

​
Example Request

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

​
Example Response

​
Project Configuration

​
Clipping Projects

For clipping projects, the response includes:
  • topics: AI-identified topics in the video
  • clipDurations: Preferred clip length ranges
  • genre: Video genre for better AI analysis
  • reframeClips: Whether clips are reframed for different aspect ratios

​
Caption Projects

For caption projects, the response includes:
  • captionsPreset: Style preset for captions
  • enableEmojies: Whether emojis are added
  • enableHighlights: Whether keywords are highlighted
  • language: Primary language of the content

​
Reframe Projects

For reframe projects, the response includes:
  • exportOrientation: Target orientation (portrait/square)
  • genre: Video genre for better reframing
  • reframeClips: Always true for reframe projects

​
Dubbing Projects

For dubbing projects, the response includes:
  • language: Source language of the video
  • dubbingLanguage: Target language for dubbing
  • translateTranscription: Whether transcription is translated

​
URLs Object

The urls object may contain various project assets:
​
sourceVideo
string
URL to the original source video
​
thumbnail
string
URL to the project thumbnail image
​
videoFile
string
URL to the processed video file (for caption/reframe projects)
URLs are dynamically generated and may expire. Always use the most recent URLs from API responses.

​
Rate Limiting

This endpoint is subject to the standard rate limit of 10 requests per minute.

​
Common Use Cases

Project Monitoring

Get detailed status and configuration information

Configuration Review

Verify project settings and parameters

Metadata Analysis

Access video metadata and processing details

Asset Management

Retrieve URLs for project assets and files

​
Next Steps

Based on the project details: