v3

latestOpenAPI 3.0.0Proprietary2026-08-041323140.2 KB
Export from Descript

Get Published Project Metadata

Retrieve metadata for a published Descript project by its URL slug. This endpoint provides information about the published project including title, duration, publisher details, privacy settings, and subtitles.

This endpoint requires authentication using a personal token and is subject to rate limiting of 1000 requests per hour per user.

get/published_projects/{publishedProjectSlug}

Path parameters

publishedProjectSlugstring required

The unique URL slug identifying the published project

Response

Successfully retrieved published project metadata.

download_urlstring uri

A time-limited signed URL for downloading the original published media file. See download_url_expires_at for expiration date.

download_url_expires_atstring date-time

ISO 8601 timestamp indicating when the download_url expires. Present when download_url is present.

project_idstring uuid required

The unique identifier of the source Descript project

publish_type'audio' | 'video' | 'audiogram' required

The type of published project

privacy'public' | 'unlisted' | 'private' | 'drive' | 'password' required

The access permission level for this published project

subtitlesstring required

Full VTT-formatted subtitle/caption content for the published project

Example response

{
  "download_url": "https://storage.googleapis.com/bucket/file.mp4?X-Goog-Signature=...",
  "download_url_expires_at": "2025-01-16T10:30:00.000Z",
  "project_id": "12345678-1234-5678-1234-567812345678",
  "publish_type": "video",
  "privacy": "unlisted",
  "metadata": {
    "title": "My Video Project",
    "duration_seconds": 125.456,
    "duration_formatted": "00:02:05",
    "published_at": "2025-01-15T10:30:00.000Z",
    "published_by": {
      "first_name": "Jane",
      "last_name": "Doe"
    }
  },
  "subtitles": "WEBVTT\\n\\n00:00:00.000 --> 00:00:02.000\\nWelcome to my video"
}