Get Published Project

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}

Get Published Project Metadata

cURL

curl --request GET \
  --url https://descriptapi.com/v1/published_projects/{publishedProjectSlug} \
  --header 'Authorization: Bearer <token>'

200

{
  "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",
  "download_url": "https://storage.googleapis.com/bucket/file.mp4?X-Goog-Signature=...",
  "download_url_expires_at": "2025-01-16T10:30:00.000Z"
}

Authorizations

Authorization · string · header · required

Personal API token created in Descript Settings → API Tokens. See the Authentication section for details.

Path Parameters

publishedProjectSlug · string · required

The unique URL slug identifying the published project

Response

200

application/json

Successfully retrieved published project metadata.

Metadata for a successfully published Descript project

project_id · string<uuid> · required

The unique identifier of the source Descript project

Example:

"12345678-1234-5678-1234-567812345678"

publish_type · enum<string> · required

The type of published project

Available options: audio, video, audiogram

Example:

"video"

privacy · enum<string> · required

The access permission level for this published project

Available options: public, unlisted, private, drive, password

Example:

"unlisted"

metadata · object · required

Detailed metadata about the published project

Show child attributes

subtitles · string · required

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

Example:

"WEBVTT\\n\\n00:00:00.000 --> 00:00:02.000\\nWelcome to my video"

download_url · string<uri>

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

Example:

"https://storage.googleapis.com/bucket/file.mp4?X-Goog-Signature=..."

download_url_expires_at · string<date-time>

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

Example:

"2025-01-16T10:30:00.000Z"