Endpoints

GET /transcripts/{id}

The query for a transcript by UUID.

Example: Request for a transcript.

curl -X GET \
https://api.atext.io/v1/transcripts/UUID \
-H 'Authorization: Basic AUTHORIZATION_TOKEN'

Expected Response when and audio has been processing:

{
"uuid": "16a54748-da46-4080-b4a1-fa18a6b223cf",
"status": "processing",
"audioSrcUrl": "AUDIO_URL",
"language": "es",
"locale": "US",
"tags": [
"sample",
"demo-1"
],
"speakerCount": 2,
"options": {
"formatText": false,
"truncatedWords": false
},
"createdAt": "2019-12-08T01:25:49.031Z"
}

Expected Response when and audio has been transcribed:

{
"uuid":"5769e0e2-96cb-488d-8723-8983e19d7c15",
"results":
{
"transcripts":
[
{
"transcript":"You know, demons on TV like that. And... And for people to expose themselves to being rejected on TV or... You know, her hum*... Humiliated by fear factor or... Um... You know."
}
],
"items":
[
{
"startTime":"00:00:00",
"endTime":"00:00:05",
"alternatives":
[
{
"content":" You know, demons on TV like that."
}
],
"type":"phrase",
},
{
"startTime":"00:00:05",
"endTime":"00:00:05",
"alternatives":
[
{
"content":"And..."
}
],
"type":"phrase",
},
{
"startTime":"00:00:05",
"endTime":"00:00:05",
"alternatives":
[
{
"content":"And for people to expose themselves to being rejected on TV or..."
}
],
"type":"phrase",
},
{
"startTime":"00:00:05",
"endTime":"00:00:05",
"alternatives":
[
{
"content":"You know, her hum*..."
}
],
"type":"phrase with truncated word",
},
{
"startTime":"00:00:05",
"endTime":"00:00:05",
"alternatives":
[
{
"content":"Humiliated by fear factor or..."
}
],
"type":"phrase",
},
{
"startTime":"00:00:05",
"endTime":"00:00:05",
"alternatives":
[
{
"content":"Um..."
}
],
"type":"phrase with non-verbal human noise (interjection)",
},
{
"startTime":"00:00:05",
"endTime":"00:00:05",
"alternatives":
[
{
"content":"You know."
}
],
"type":"phrase",
},
]
},
"status":"completed"
}
}

Below is a detailed explanation of the response data from this endpoint:

Key Description Example Value Data Type
status Status of the transcription. It can be starting, processing, completed, or error. If the status is an error, there will also be an error key in the response with more information about the error. "processing" string
tags These tags allow you to group and filter media files [ "demo", "project-1" ] Array of strings
audioSrcUrl   This is the source for the audio file that was sent to Atexto   string
transcripts     Humans generate transcription at our crowdsourcing platform. "Hello, today I am going to be discussing cats." string
items An array of each phrase in the transcript, with the time each word was spoken, and the confidence score for each word. Timestamps are in milliseconds. [{"start": 0, "end": 1000, "text": "Hello"}, {"start": 1200, "end": 1500, "text": "world"}, … ] list of objects