Get paragraphs in transcript — AssemblyAI

Get the transcript split by paragraphs. The API will attempt to semantically segment your transcript into paragraphs to create more reader-friendly transcripts.

Path parameters

transcript_idstringRequired

ID of the transcript

Response

This endpoint returns an object.

idstring

The unique identifier of your transcript

confidencedouble>=0<=1

The confidence score for the transcript

audio_durationdouble

The duration of the audio file in seconds

paragraphslist of objects

An array of paragraphs in the transcript

Errors

1 curl https://api.assemblyai.com/v2/transcript/transcript_id/paragraphs \ 2 -H "Authorization: <apiKey>"

1 { 2 "id": "d5a3d302-066e-43fb-b63b-8f57baf185db", 3 "confidence": 0.9578730257009361, 4 "audio_duration": 281, 5 "paragraphs": [ 6 { 7 "text": "Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter Decarlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University. Good morning, professor.", 8 "start": 250, 9 "end": 26950, 10 "confidence": 0.73033, 11 "words": [ 12 { 13 "confidence": 0.73033, 14 "start": 250, 15 "end": 650, 16 "text": "Smoke" 17 }, 18 { 19 "confidence": 1, 20 "start": 730, 21 "end": 1022, 22 "text": "from" 23 }, 24 { 25 "confidence": 0.99992, 26 "start": 1076, 27 "end": 1466, 28 "text": "hundreds" 29 }, 30 { 31 "confidence": 1, 32 "start": 1498, 33 "end": 1646, 34 "text": "of" 35 } 36 ] 37 }, 38 { 39 "text": "Good morning. So what is it about the conditions right now that have caused this round of wildfires to affect so many people so far away? Well, there's a couple of things. The season has been pretty dry already, and then the fact that we're getting hit in the US. Is because there's a couple of weather systems that are essentially channeling the smoke from those Canadian wildfires through Pennsylvania into the Mid Atlantic and the Northeast and kind of just dropping the smoke there.", 40 "start": 27850, 41 "end": 56190, 42 "confidence": 0.99667, 43 "words": [ 44 { 45 "confidence": 0.99667, 46 "start": 27850, 47 "end": 28262, 48 "text": "Good" 49 }, 50 { 51 "confidence": 0.99742, 52 "start": 28316, 53 "end": 28920, 54 "text": "morning." 55 }, 56 { 57 "confidence": 0.94736, 58 "start": 29290, 59 "end": 29702, 60 "text": "So" 61 } 62 ] 63 } 64 ] 65 }

1	curl https://api.assemblyai.com/v2/transcript/transcript_id/paragraphs \
2	-H "Authorization: <apiKey>"

1	{
2	"id": "d5a3d302-066e-43fb-b63b-8f57baf185db",
3	"confidence": 0.9578730257009361,
4	"audio_duration": 281,
5	"paragraphs": [
6	{
7	"text": "Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter Decarlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University. Good morning, professor.",
8	"start": 250,
9	"end": 26950,
10	"confidence": 0.73033,
11	"words": [
12	{
13	"confidence": 0.73033,
14	"start": 250,
15	"end": 650,
16	"text": "Smoke"
17	},
18	{
19	"confidence": 1,
20	"start": 730,
21	"end": 1022,
22	"text": "from"
23	},
24	{
25	"confidence": 0.99992,
26	"start": 1076,
27	"end": 1466,
28	"text": "hundreds"
29	},
30	{
31	"confidence": 1,
32	"start": 1498,
33	"end": 1646,
34	"text": "of"
35	}
36	]
37	},
38	{
39	"text": "Good morning. So what is it about the conditions right now that have caused this round of wildfires to affect so many people so far away? Well, there's a couple of things. The season has been pretty dry already, and then the fact that we're getting hit in the US. Is because there's a couple of weather systems that are essentially channeling the smoke from those Canadian wildfires through Pennsylvania into the Mid Atlantic and the Northeast and kind of just dropping the smoke there.",
40	"start": 27850,
41	"end": 56190,
42	"confidence": 0.99667,
43	"words": [
44	{
45	"confidence": 0.99667,
46	"start": 27850,
47	"end": 28262,
48	"text": "Good"
49	},
50	{
51	"confidence": 0.99742,
52	"start": 28316,
53	"end": 28920,
54	"text": "morning."
55	},
56	{
57	"confidence": 0.94736,
58	"start": 29290,
59	"end": 29702,
60	"text": "So"
61	}
62	]
63	}
64	]
65	}