/v2/transcript/{id}/paragraphs

    You can use this endpoint to retrieve completed transcripts broken into individual paragraphs. The model will semantically divide the transcript into paragraphs by analyzing things such as time in between completed thoughts and speech patterns.

    GET Params

    When making GET requests against this endpoint, you need to include the "id" of your transcript in the URL. For example, this would be the full URL to GET one of your transcripts.

    https://api.assemblyai.com/v2/transcript/{TRANSCRIPT-ID}/paragraphs
    Make sure you include the authorization header in the GET request! You can read more about Authentication here.

    GET Response

    When you make a GET request, the API will respond with the following JSON response.

    {
       "paragraphs":[
          {
             "text":"Hello. I'm Sunny Williams. I'm up here on the International Space Station. So this is No two. This is a really cool module.",
             "start":770,
             "end":10710,
             "confidence":0.97,
             "words":[
                {"text": "Hello.", "start": 100, "end": 1000, "confidence": 0.99},
                "..."
             ]
          },
          {
             "text":"Of course, most of these modules, you'll see, they have four sides and they're put together that way we could sort of work on a flat plane, either a wall, a floor, another wall, or the ceiling. But again, all you have to do is turn yourself and your reference changes. The reason I'm bringing that up is because this is where four out of six of us sleep. And so people always ask about sleeping in space. Do you lie down?",
             "start":11370,
             "end":39060,
             "confidence":0.99,
             "words":[
                {"text": "Of.", "start": 12, "end": 450, "confidence": 0.99},
                "..."
             ]
          },
          {
             "text":"Are you in a bed? Not really, because it doesn't matter. You don't really have the sensation of lying down. You just sit in your sleeping bag. So Here's one sleep station right here.",
             "start":39070,
             "end":50250,
             "confidence":0.99,
             "words":[
                {"text": "Are.", "start": 45, "end": 290, "confidence": 0.99},
                "..."
             ]
          },
    
            "......"
    
        ],
        "id": "3otc28umy-25ae-4446-b133-70e244be5208",
        "confidence": 0.951530612244907,
        "audio_duration": 521.352
    }

    GET Response Params

    Param Example Info
    paragraphs {"paragraphs": [{'text': '...', 'start': 100, 'end': 1100, 'words': [...], 'confidence': 0.99"}, ...]} Will contain an array of objects containing the keys: text, start, end, confidence and words.
    id "5551722-f677-48a6-9287-39c0aafd9ac1" The unique id of your transcription.
    audio_duration 12.09 How many seconds of audio we found in your audio file.
    confidence 0.956 The confidence score of the entire transcription, between 0 and 1.