---
title: "Get Published Project Metadata"
method: GET
path: "/published_projects/{publishedProjectSlug}"
tags: ["Export from Descript"]
---

# Get Published Project Metadata

`GET /published_projects/{publishedProjectSlug}`

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.

## Path parameters

- `publishedProjectSlug` string, required

## Response `200`

Successfully retrieved published project metadata.

- PublishedProjectMetadata — Metadata for a successfully published Descript project
  - `download_url` string, uri — A time-limited signed URL for downloading the original published media file. See download_url_expires_at for expiration date.
  - `download_url_expires_at` string, date-time — ISO 8601 timestamp indicating when the download_url expires. Present when download_url is present.
  - `project_id` string, 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
  - `metadata` object, required — Detailed metadata about the published project
    - `title` string — The title of the published project
    - `duration_seconds` number — Duration of the published content in seconds (rounded to nearest millisecond)
    - `duration_formatted` string — Human-readable duration in HH:MM:SS format
    - `published_at` string, date-time — ISO 8601 timestamp of when the project was published
    - `published_by` object — Information about the user who published the project
      - `first_name` string — First name of the publisher
      - `last_name` string — Last name of the publisher
  - `subtitles` string, required — Full VTT-formatted subtitle/caption content for the published project

## Other responses

- `401` — Unauthorized - invalid or missing authentication token.
- `403` — Forbidden - user does not have access to this published project.
- `404` — Not found - published project does not exist.
- `409` — Conflict - published project is in an invalid state (processing or failed).
- `429` — Too many requests - rate limit exceeded. Use the `Retry-After` header to determine when to retry.

---

[API](https://skmtc.dev/descriptapi/apis/descript-api.md) · [All operations](https://skmtc.dev/descriptapi/apis/descript-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/descriptapi/descript-api/revisions/04c0005aef70/schema)