Developer Docs

Exports

Export a finished Trint transcript or Story Builder document in a wide range of formats — documents, captions, editing timelines and CSV data.

Once a transcript has finished processing you can download it in many different formats, from plain text and Microsoft Word to broadcast captions and non-linear editing timelines. Every export endpoint is a GET request that takes the transcript's trint-id (or, for Story Builder, the document's file-id) as a path parameter and returns the rendered file as the response body.

Authenticate with Basic Authentication using your API key ID and secret. Most caption and document formats accept query parameters to fine-tune the output — for example captions-by-paragraph, max-subtitle-character-length or enable-speakers for subtitle formats. The available parameters for each format are listed against the operation below.

Trint must be ready

Exports are only available once transcription has completed. Poll the Transcripts API for the transcript's status, or register a webhook to be notified when it is ready to export.

Document exports

Export the full transcript as a document or structured data file.

Microsoft Word (docx)

gethttps://api.trint.com/export/docx/{trint-id}

Export a Trint as a .docx document

Path parameters

trint-idstringrequired

Query parameters

highlights-onlybooleanoptional

Export highlighted text only

enable-paragraph-timecodesbooleanoptional

Append the paragraph timecode to the start of each paragraph

speaker-before-timecodebooleanoptional

Append the paragraph timecode before the speaker name

exclude-speaker-namesbooleanoptional

Do not include the speaker names in the resulting document

Headers

api-keystringrequired
GET /docx/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/docx/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.docx',
}
200200
400400

Text

gethttps://api.trint.com/export/text/{trint-id}

Export a Trint in plain text format

Path parameters

trint-idstringrequired

Id. of the Trint to export

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /text/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/text/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
  "title": "A sample Trint title",
  "url": "https://storage/transcriptId.txt"
}
200200
400400

HTML

gethttps://api.trint.com/export/html/{trint-id}

Export a Trint in HTML format

Path parameters

trint-idstringrequired

Id. of the Trint to export

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /html/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/html/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

JSON

gethttps://api.trint.com/export/json/{trint-id}

Export a Trint in JSON format

Path parameters

trint-idstringrequired

Id. of the Trint to export

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /json/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/json/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
  "title": "Trint title.mp4",
  "words": [
    {
      "paragraphId": "paragraphId1",
      "speaker": "speakerId1",
      "value": "Text ",
      "duration": 61,
      "time": 7584,
      "highlightColor": "yellow",
      "strikethrough": false
    },
    {
      "paragraphId": "paragraphId1",
      "speaker": "speakerId1",
      "value": "content. ",
      "duration": 260,
      "time": 4407,
      "highlightColor": "yellow"
    },
    {
      "paragraphId": "paragraphId2",
      "speaker": "speakerId2",
      "value": "Text ",
      "duration": 270,
      "time": 4668
    },
    {
      "paragraphId": "paragraphId2",
      "speaker": "speakerId2",
      "value": "content. ",
      "duration": 540,
      "time": 4938
    }
  ],
  "speakers": {
    "speakerId1": {
      "name": "Speaker 1"
    },
    "speakerId2": {
      "name": "Speaker 2"
    }
  },
  "paragraphs": {
    "paragraphId1": {
      "verify": {
        "author": null,
        "status": "DEFAULT"
      }
    },
    "paragraphId2": {
      "verify": {
        "author": null,
        "status": "DEFAULT"
      }
    }
  },
  "realtime": {
    "status": "STOPPED"
  }
}
200200
400400

XML

gethttps://api.trint.com/export/xml/{trint-id}

Export a Trint in a flattened .xml format

Path parameters

trint-idstringrequired

Id. of the Trint to export

Query parameters

skip-strikethroughsbooleanoptional

Skips strikethroughs (can be applied to any export format)

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /xml/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/xml/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.xml',
}
200200
400400

Transcript CSV

gethttps://api.trint.com/export/csv/full/{trint-id}

Export a given Trint in CSV format

Path parameters

trint-idstringrequired

ID of the Trint to export

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /csv/full/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/csv/full/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'My Trint',
  url: 'https://storage/My_Trint_full.csv',
}
200200
400400

Caption & subtitle exports

Generate caption and subtitle files for broadcast and video workflows. These formats share query parameters such as captions-by-paragraph, max-subtitle-character-length, enable-speakers and highlights-only to control how lines are split and labelled.

SubRip SRT

gethttps://api.trint.com/export/srt/{trint-id}

Export a Trint as Subrip .srt format subtitles

Path parameters

trint-idstringrequired

id of the Trint to export

Query parameters

captions-by-paragraphbooleanoptional

Creates caption per paragraph instead of automating caption lengths (ignores: max-subtitle-length)

max-subtitle-character-lengthinteger (int32)optional

Sets maximum character count before breaking to a new line or caption. Also calculates maximum time before breaking into new caption (49ms/character), and minimum time before caption is allowed to break if in same paragraph (21ms/character).

highlights-onlybooleanoptional

Export highlighted text only

enable-speakersbooleanoptional

Adds each associated speaker name to captions

speaker-on-new-linebooleanoptional

Sets speaker names to be shown on a new line instead of inline

speaker-uppercasebooleanoptional

Sets all speaker names to uppercase

skip-strikethroughsbooleanoptional

Skips strikethroughs (can be applied to any export format)

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /srt/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/srt/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.srt',
}
200200
400400

WebVTT

gethttps://api.trint.com/export/webvtt/{trint-id}

Export a Trint as WebVTT .vtt format subtitles

Path parameters

trint-idstringrequired

Id. of the Trint to export

Query parameters

captions-by-paragraphbooleanoptional

Creates caption per paragraph instead of automating caption lengths (ignores: max-subtitle-length)

max-subtitle-character-lengthinteger (int32)optional

Sets maximum character count before breaking to a new line or caption. Also calculates maximum time before breaking into new caption (49ms/character), and minimum time before caption is allowed to break if in same paragraph (21ms/character).

highlights-onlybooleanoptional

Export highlighted text only

enable-speakersbooleanoptional

Adds each associated speaker name to captions

speaker-on-new-linebooleanoptional

Sets speaker names to be shown on a new line instead of inline

speaker-uppercasebooleanoptional

Sets all speaker names to uppercase

skip-strikethroughsbooleanoptional

Skips strikethroughs (can be applied to any export format)

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /webvtt/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/webvtt/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.vtt',
}
200200
400400

Spruce STL

gethttps://api.trint.com/export/spruce-stl/{trint-id}

Export a Trint as Spruce .stl format subtitles

Path parameters

trint-idstringrequired

Id. of the Trint to export

Query parameters

frame-rateinteger (int32)optional

Sets the frame rate used to generate the caption timings. Default: 30

captions-by-paragraphbooleanoptional

Creates caption per paragraph instead of automating caption lengths (ignores: max-subtitle-length)

max-subtitle-character-lengthinteger (int32)optional

Sets maximum character count before breaking to a new line or caption. Also calculates maximum time before breaking into new caption (49ms/character), and minimum time before caption is allowed to break if in same paragraph (21ms/character).

highlights-onlybooleanoptional

Export highlighted text only

enable-speakersbooleanoptional

Adds each associated speaker name to captions

speaker-on-new-linebooleanoptional

Sets speaker names to be shown on a new line instead of inline

speaker-uppercasebooleanoptional

Sets all speaker names to uppercase

skip-strikethroughsbooleanoptional

Skips strikethroughs (can be applied to any export format)

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /spruce-stl/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/spruce-stl/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.stl',
}
200200
400400

Avid DS

gethttps://api.trint.com/export/avid-ds/{trint-id}

Export a Trint as Avid DS .txt format subtitles

Path parameters

trint-idstringrequired

Id. of the Trint to export

Query parameters

frame-rateinteger (int32)optional

Sets the frame rate used to generate the caption timings. Default: 25

captions-by-paragraphbooleanoptional

Creates caption per paragraph instead of automating caption lengths (ignores: max-subtitle-length)

max-subtitle-character-lengthinteger (int32)optional

Sets maximum character count before breaking to a new line or caption. Also calculates maximum time before breaking into new caption (49ms/character), and minimum time before caption is allowed to break if in same paragraph (21ms/character).

highlights-onlybooleanoptional

Export highlighted text only

enable-speakersbooleanoptional

Adds each associated speaker name to captions

speaker-on-new-linebooleanoptional

Sets speaker names to be shown on a new line instead of inline

speaker-uppercasebooleanoptional

Sets all speaker names to uppercase

skip-strikethroughsbooleanoptional

Skips strikethroughs (can be applied to any export format)

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /avid-ds/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/avid-ds/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.txt',
}
200200
400400

Telestream Vantage XML

gethttps://api.trint.com/export/vantage-xml/{trint-id}

Export a Trint as Telestream Vantage XML captions

Path parameters

trint-idstringrequired

Id. of the Trint to export

Query parameters

frame-rateinteger (int32)optional

Sets the frame rate used to generate the caption timings. Default: 25

captions-by-paragraphbooleanoptional

Creates caption per paragraph instead of automating caption lengths (ignores: max-subtitle-length)

max-subtitle-character-lengthinteger (int32)optional

Sets maximum character count before breaking to a new line or caption. Also calculates maximum time before breaking into new caption (49ms/character), and minimum time before caption is allowed to break if in same paragraph (21ms/character).

highlights-onlybooleanoptional

Export highlighted text only

enable-speakersbooleanoptional

Adds each associated speaker name to captions

speaker-on-new-linebooleanoptional

Sets speaker names to be shown on a new line instead of inline

speaker-uppercasebooleanoptional

Sets all speaker names to uppercase

skip-strikethroughsbooleanoptional

Skips strikethroughs (can be applied to any export format)

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /vantage-xml/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/vantage-xml/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.xml',
}
200200
400400

Editing & timeline exports

Export highlights and markers as timelines for non-linear editing suites.

Edit Decision List - EDL

gethttps://api.trint.com/export/edl/{trint-id}

Export Trint highlights as an Edit Decision List .edl file

Path parameters

trint-idstringrequired

Id. of the Trint to export

Query parameters

skip-strikethroughsbooleanoptional

Skips strikethroughs (can be applied to any export format)

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /edl/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/edl/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'A sample Trint title',
  url: 'https://storage/transcriptId.edl',
}
200200
400400

Premiere XML

gethttps://api.trint.com/export/premiere-xml/{trint-id}

Exports Trints as a project, compatible with Adobe Premiere Pro, Adobe Audition and Final Cut Pro 7, that exposes markers with speakers and paragraphs to make clips searchable.

Path parameters

trint-idstringrequired

ID of the Trint to export

Headers

api-keystringoptional

Create an API key: https://app.trint.com/account/api

GET /premiere-xml/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/premiere-xml/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

Response 200

200 response
{
	title: 'My Trint',
  url: 'https://storage/My_Trint.xml',
}
200200
400400

Comments, highlights & markers (CSV)

Export the annotations on a Trint — comments, highlights and markers — as CSV data.

Comments (CSV)

gethttps://api.trint.com/export/csv/comments/{trint-id}

Export comments from a given Trint in CSV format

Path parameters

trint-idstringrequired

ID of the Trint to export

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /csv/comments/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/csv/comments/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'My Trint',
  url: 'https://storage/My_Trint_comments.csv',
}
200200
400400

Highlights (CSV)

gethttps://api.trint.com/export/csv/highlights/{trint-id}

Export highlights from a given Trint in CSV format

Path parameters

trint-idstringrequired

ID of the Trint to export

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /csv/highlights/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/csv/highlights/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'My Trint',
  url: 'https://storage/My_Trint_highlights.csv',
}
200200
400400

Markers (CSV)

gethttps://api.trint.com/export/csv/markers/{trint-id}

Export markers from a given Trint in CSV format

Path parameters

trint-idstringrequired

ID of the Trint to export

Headers

api-keystringrequired

Create an API key: https://app.trint.com/account/api

GET /csv/markers/{trint-id}
curl --request GET \  --url 'https://api.trint.com/export/csv/markers/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'api-key: YOUR_API-KEY'

Response 200

200 response
{
	title: 'My Trint',
  url: 'https://storage/My_Trint_markers.csv',
}
200200
400400

Story Builder exports

Export a Story Builder document. These endpoints take the document's file-id instead of a trint-id.

Microsoft Word (.docx)

gethttps://api.trint.com/export/story-builder/docx/{file-id}

Export a Story Builder document as a .docx file

Path parameters

file-idstringrequired

id of the Story Builder file

GET /story-builder/docx/{file-id}
curl --request GET \  --url 'https://api.trint.com/export/story-builder/docx/:file-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

Response 200

200 response
{
  "title": "My Story Builder",
  "url": "https://storage/transcriptId.edl"
}
200200
400400

Premiere XML

gethttps://api.trint.com/export/story-builder/project_xml/{file-id}

Export a Story Builder document to Adobe Premiere compatible .xml file

Path parameters

file-idstringrequired

ID of the Story to export

Headers

api-keystringoptional

Create an API key: https://app.trint.com/account/api

GET /story-builder/project_xml/{file-id}
curl --request GET \  --url 'https://api.trint.com/export/story-builder/project_xml/:file-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

Response 200

200 response
{
	title: 'My Trint',
  url: 'https://storage/My_Trint.xml',
}
200200
400400

Editorial Decision List (EDL)

gethttps://api.trint.com/export/story-builder/edl/{file-id}

Export a Story Builder document as a .edl file

Path parameters

file-idstringrequired

id of the Story Builder file

GET /story-builder/edl/{file-id}
curl --request GET \  --url 'https://api.trint.com/export/story-builder/edl/:file-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

Response 200

200 response
{
  "title": "My Story Builder",
  "url": "https://storage/transcriptId.edl"
}
200200
400400