Quickstart

Welcome to the Atexto API! You can use our API to access Atexto API endpoints, which can create and access human tasks for audio transcription and tagging.

Step 1: Turn audio into text with humans

Run the below cURL command to request a transcript for an audio clip. The API will download and transcribe the audio at our crowdsourcing platform.

curl --request POST \     
  --url 'https://api.atext.io/transcripts' \     
  --header 'authorization: your-secret-api-token' \     
  --data '
    {
    "audioSrcUrl": "https://s3.amazonaws.com/atexto-production/mp3/7510.mp3" 
    }'

You'll get a response with the  id of the transcript and the status of the transcript request (keep track of this id!):

{
"Id":"40","results":
  {
  "transcripts":
    [
      {
       "transcript":null
      }
    ],
  "items":null
  },
  "status":"processing"
  }
}

When you create a transcript, the status goes from  queued to processing to completed. Processing time normally takes under 24 hours.

To get the results, pull for the transcript  id with GET requests until the status is completed (webhooks are coming soon).

Replace 40 in the below curl command to the id of your transcript returned in the above API call.

curl --request GET \   
  --url https://api.atext.io/transcripts/40 \   
  --header 'authorization: your-secret-api-token'

The response should eventually look like this:

{
"Id":"40","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":
        [
          {
          "consensus":"5",
          "judgements":"28",
          "content":" You know, demons on TV like that."
          }
        ],
      "type":"phrase",
      "intent":"undefined"
      },
      {
      "startTime":"00:00:05",
      "endTime":"00:00:05",
      "alternatives":
        [
          {
          "consensus":"3",
          "judgements":"9",
          "content":"And..."
          }
        ],
      "type":"phrase",
      "intent":"undefined"
      },
      {
      "startTime":"00:00:05",
      "endTime":"00:00:05",
      "alternatives":
        [
          {
          "consensus":"5",
          "judgements":"12",
          "content":"And for people to expose themselves to being rejected on TV or..."
          }
        ],
      "type":"phrase",
      "intent":"undefined"
      },
      {
      "startTime":"00:00:05",
      "endTime":"00:00:05",
      "alternatives":
        [
          {
          "consensus":"5",
          "judgements":"12",
          "content":"You know, her hum*..."
          }
        ],
      "type":"phrase with truncated word",
      "intent":"undefined"
      },
      {
      "startTime":"00:00:05",
      "endTime":"00:00:05",
      "alternatives":
        [
          {
          "consensus":"3",
          "judgements":"5",
          "content":"Humiliated by fear factor or..."
          }
        ],
      "type":"phrase",
      "intent":"undefined"
      },
      {
      "startTime":"00:00:05",
      "endTime":"00:00:05",
      "alternatives":
        [
          {
          "consensus":"3",
          "judgements":"5",
          "content":"Um..."
          }
        ],
      "type":"phrase with non-verbal human noise (interjection)",
      "intent":"undefined"
      },
      {
      "startTime":"00:00:05",
      "endTime":"00:00:05",
      "alternatives":
        [
          {
          "consensus":"3",
          "judgements":"5",
          "content":"You know."
          }
        ],
      "type":"phrase",
      "intent":"undefined"},
      ]
    },
  "status":"completed"
  }
}

That's all there is to it!

If you ever need any help or support, use the Contact Us form in the bottom right -- or send us an email to [email protected]

Still need help? Contact Us Contact Us