Get Transcripts

Returns the available transcripts for an event

GET /events-v2/{event_id}/transcript

Parameter	Type	DataType	Description
event_id	path	integer	The event id for which to fetch the transcripts
modified_since	query	datetime	Returns transcripts modified since this date
linguistics	query	boolean	Whether to include linguistics metadata in the response
pricing	query	boolean	Whether to include price reaction information
improved_only	query	boolean	Whether or not to only return the post-realtime improved transcripts
include_deleted	query	boolean	Whether or not to include deleted transcripts
include_everything	query	boolean	Whether or not to include any transcripts, regardless of offset (if available)
word_offsets	query	boolean	Whether to include word-by-word durations and offsets

NOTE

modified_since Can be used to continually fetch just the newer transcripts during a live event.

Response

[
    {
		"transcript_item_id": 99350456,
		"transcript": "Our guidance incorporates the order trends that we've seen to date and what we believe today to be appropriate assumptions. Our results are inherently unpredictable and maybe materially affected by many factors, including uncertainty regarding the impacts of the COVID-19 pandemic fluctuations in foreign exchange rates changes in global economic and geopolitical conditions and customer.",
		"timestamp": "2022-10-27T17:33:30-04:00",
		"start_ms": 60218,
		"duration_ms": 20300,
        "speaker_id": 1058672,
        "speaker_type": "dia",
        "speaker_name": "John Doe",
        "speaker_title": "President",
        "person_id": 12345,
        "original": "with 60% unhedged in the second half of 2023. This provides us with significant exposure to a rising oil price environment.",
        "is_translated": false,
		"audio_url": "https://audio.aiera.com/api/events/2270838/transcript/99350456/audio",
        "is_improved": false,
        "is_edited": false,
        "status": "active",
		"modified": "2022-10-27T18:31:55",
		"linguistics": {
            "summaries": [
				{
					"title": null,
					"summary": [
						"Guidance incorporates order trends, and results are inherently unpredictable."
					],
					"model": "zeroshot",
                    "type": "presentation",
                    "version": "published",
                    "audio_clip": null,
                    "video_clip": null,
                    "priority": 4,
                    "created": "2024-01-12T09:47:05",
                    "modified": "2024-01-28T19:19:38"
				}
			],
			"topics": [
				{
					"topic_id": 11,
					"topic": "COVID",
					"priority": 1
				}
			],
            "auto_tags": [
                "Guidance Change",
                "Expense Forecast",
                "Revenue Miss"
            ],
			"sentiment": {
				"average": -0.2294,
				"median": -0.4588
			},
			"sentiment_breakouts": [
				{
					"start_offset": 0,
					"end_offset": 123,
					"sentiment": 0.0
				},
				{
					"start_offset": 124,
					"end_offset": 388,
					"sentiment": -0.4588
				}
			]
		},
        "price_data": {
            "after_transcript": {
                "trade_time": "2023-02-07T17:54:39",
                "price": 267.96,
                "volume": 50549569
            }
        }
	}
]

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/events/{event_id}/transcript' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.get("https://premium.aiera.com/api/events/{event_id}/transcript", headers={"X-API-Key": "xxx"})