Transcripts

List the files in your account or a Shared Drive, and retrieve an individual file by ID.

The Transcripts API lets you browse the files in your account and fetch metadata for any individual file. Each file returns its id, title, language, duration and other metadata. Authenticate every request with Basic Authentication using your API key ID and secret.

Files come in three formats

A file's fileType is one of TRANSCRIPT, CAPTION or STORY. A Trint Story is free text, titles and quotes drawn from your Transcript files that can be played back in sequence — useful for rough cuts or collecting research quotes.

List all files

Returns a list of files (id, title and other metadata) belonging to the current user or accessible via a specified Shared Drive. Supply a sharedDriveId to list the contents of that drive — regardless of which user the files belong to — and add a folderId to scope the results to a single folder within it. Without those parameters, the endpoint returns the files belonging to the user whose API key is supplied. Use the limit and skip query parameters to paginate (limit accepts 1–1000).

Workspace is the old name for Shared Drive

For backwards compatibility you can pass workspaceId instead of sharedDriveId — the two are equivalent.

List Files

gethttps://api.trint.com/transcripts/

The list files endpoint returns a list of files (id, title etc) belonging to the current user or accessible via a specified Shared Drive. If a sharedDriveId, the results will list the contents of that drive (or drive Folder if a folderId is also supplied), no matter which user the Trints belong to. Otherwise the results will list the Trints belonging to the user whose API key is supplied. NB: Workspace is simply the old terminology for Shared Drive, calls can be made with a workspaceId instead of a sharedDriveId for backwards compatibility.

Query parameters

limitinteger (int32)optional

Maximum number of transcripts to return. (Minimum value 1, Maximum value 1000)

skipinteger (int32)optional

Number of transcripts to skip before returning

sharedDriveIdstringoptional

ID of a Trint Shared Drive

workspaceId (deprecated)stringoptional

see sharedDriveId (alternate param name for backwards compatibility)

folderIdstringoptional

ID of a Trint Shared Drive Folder (NB: when used, a sharedDriveId/workspaceId must also be given)

GET /

curl --request GET \  --url 'https://api.trint.com/transcripts/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

Response 200

200 response

[
  {
    "id": "JbDdNjvGQ8mCKWvDA_tX9Q",
    "fileType": "TRANSCRIPT",
    "workspaceId": null,
    "folderId": null,
    "language": "en",
    "duration": 100000,
    "title": "obama.mp4",
    "metadata": "Arbitrary metadata string",
    "excerpt": "Our diversity. Our commitment to rule of law. These things give us everything we need to ensure prosperity and security for generations to come. In fact, it's in that spirit. That we have made progress these past seven years.",
    "timecodeOffsetEnabled": true,
    "timecode": "00:00:00.000",
    "notes": "Notes string",
    "updated": "2011-10-10T14:48:00.000Z",
    "created": "2011-10-05T14:48:00.000Z"
  },
  {
    "id": "kmpgQ1FWQCO_bUXJwDZpnw",
    "fileType": "TRANSCRIPT",
    "workspaceId": null,
    "folderId": null,
    "language": "en",
    "duration": 100000,
    "title": "another.mp4",
    "metadata": "{\r\n\"keywords\": [\"example\", \"json\", \"metadata\"]\r\n}\r\n",
    "excerpt": "This is a small test file",
    "timecodeOffsetEnabled": true,
    "timecode": "00:00:00.000",
    "notes": "Notes string",
    "updated": "2011-10-10T14:48:00.000Z",
    "created": "2011-10-05T14:48:00.000Z"
  },
  {
    "id": "-YD9NFcxScKrL_zNnDyZFw",
    "fileType": "TRANSCRIPT",
    "workspaceId": null,
    "folderId": null,
    "language": "en",
    "duration": 100000,
    "title": "/testing/martin-luther-king-cbr.mp3",
    "metadata": "",
    "excerpt": "I am happy to join with you today in what will go down in history as the greatest demonstration for freedom in the history of our nation.",
    "timecodeOffsetEnabled": true,
    "timecode": "00:00:00.000",
    "notes": "Notes string",
    "updated": "2011-10-10T14:48:00.000Z",
    "created": "2011-10-05T14:48:00.000Z"
  }
]

200200

Retrieve a file

Fetch the metadata for a single file by its id. The response mirrors a single entry from the list files endpoint.

Retrieve File

gethttps://api.trint.com/transcripts/file/{id}

GET /file/{id}

curl --request GET \  --url 'https://api.trint.com/transcripts/file/:id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

Response 200

200 response

{
  "id": "JbDdNjvGQ8mCKWvDA_tX9Q",
  "fileType": "TRANSCRIPT",
  "workspaceId": null,
  "folderId": null,
  "language": "en",
  "duration": 100000,
  "title": "obama.mp4",
  "metadata": "Arbitrary metadata string",
  "excerpt": "Our diversity. Our commitment to rule of law. These things give us everything we need to ensure prosperity and security for generations to come. In fact, it's in that spirit. That we have made progress these past seven years.",
  "timecodeOffsetEnabled": true,
  "timecode": "00:00:00.000",
  "notes": "Notes string",
  "updated": "2011-10-10T14:48:00.000Z",
  "created": "2011-10-05T14:48:00.000Z"
}

200200

400400

Next steps

To start a new transcript, see Upload & Transcribe. To be notified when a transcript finishes processing instead of polling, register a webhook.