Skip to main content
GET
/
automation
/
get-all-projects
Get All Projects
curl --request GET \
  --url https://public.reap.video/api/v1/automation/get-all-projects \
  --header 'Authorization: Bearer <token>'
{
  "projects": [
    {
      "id": "<string>",
      "title": "<string>",
      "thumbnail": "<string>",
      "billedDuration": 123,
      "status": "queued",
      "projectType": "clipping",
      "source": "Upload",
      "genre": "talking",
      "topics": [
        "<string>"
      ],
      "clipDurations": [
        [
          123
        ]
      ],
      "selectedStart": 123,
      "selectedEnd": 123,
      "reframeClips": true,
      "exportResolution": 123,
      "exportOrientation": "landscape",
      "captionsPreset": "<string>",
      "enableCaptions": true,
      "enableEmojis": true,
      "enableHighlights": true,
      "language": "<string>",
      "dubbingLanguage": "<string>",
      "translateTranscription": true,
      "translationLanguages": [
        "<string>"
      ],
      "transcriptionScript": "native",
      "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>"
      },
      "urls": {},
      "createdAt": 123,
      "updatedAt": 123
    }
  ],
  "currentPage": 123,
  "totalPages": 123,
  "totalProjects": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.reap.video/llms.txt

Use this file to discover all available pages before exploring further.

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 a paginated list of all video projects created through the automation API. Monitor project status and access project details.

Rate Limiting

This endpoint is rate limited to 10 requests per minute per API key. Use query parameters to filter, search, and sort the results.
projectType
string[]
Filter by project type. Pass multiple values to match any of them.
  • clipping - AI clip generation
  • captions - Caption generation
  • reframe - Video reframing
  • dubbing - Voice dubbing
  • transcription - Audio transcription
status
string[]
Filter by processing status. Pass multiple values to match any of them.
  • queued - Waiting to be processed
  • processing - Currently being processed
  • completed - Processing finished successfully
  • failed - Processing failed
  • invalid - Video file was invalid
  • expired - Project has expired
Search projects by title. Case-insensitive partial match.
createdAfter
integer
Unix timestamp. Only return projects created after this time.
createdBefore
integer
Unix timestamp. Only return projects created before this time.
sortBy
string
default:"createdAt"
Field to sort by.
  • createdAt - Sort by creation date
  • updatedAt - Sort by last update date
  • duration - Sort by billed duration
sortOrder
string
default:"desc"
Sort direction.
  • asc - Ascending (oldest/shortest first)
  • desc - Descending (newest/longest first)

Response

projects
array
Array of project objects
currentPage
integer
Current page number
totalPages
integer
Total number of pages
totalProjects
integer
Total number of projects

Example Request

curl -X GET "https://public.reap.video/api/v1/automation/get-all-projects?page=1&pageSize=20&projectType=clipping&status=completed&sortBy=createdAt&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Example Response

Project Status Values

  • queued - Project is queued and waiting to be processed
  • processing - Project is currently being processed (video analysis, clip generation, etc.)
  • completed - All processing has finished successfully, clips are ready
  • failed - Processing failed due to an error
  • invalid - Video file was invalid or unsupported
  • expired - Project has expired

Project Types

  • clipping - AI-powered clip generation from long-form videos
  • captions - Caption and subtitle generation
  • reframe - Automatic video reframing for different aspect ratios
  • dubbing - Voice dubbing and translation
  • transcription - Audio transcription

Use Cases

Dashboard Creation

Build project management dashboards

Batch Processing

Monitor multiple projects simultaneously

Analytics

Track processing patterns and success rates

Content Management

Organize and categorize video projects

Authorizations

Authorization
string
header
required

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

Query Parameters

page
integer
default:1

Page number for pagination

pageSize
integer
default:10

Number of projects per page (max 100)

projectType
enum<string>[]

Filter by project type

Available options:
clipping,
captions,
reframe,
dubbing,
transcription
status
enum<string>[]

Filter by project status

Available options:
queued,
prepped,
draft,
processing,
finalizing,
completed,
invalid,
expired,
failed,
error

Search projects by title

createdAfter
integer

Filter projects created after this Unix timestamp

createdBefore
integer

Filter projects created before this Unix timestamp

sortBy
enum<string>
default:createdAt

Sort field

Available options:
createdAt,
updatedAt,
duration
sortOrder
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Response

200 - application/json

Successful response

projects
object[]
currentPage
integer
totalPages
integer
totalProjects
integer