latestOpenAPI 3.1.02026-08-2390159290.1 KB

350e9cbcb623

Audio Emotion API

Get Audio Details

Retrieve all details for a specific audio directly from the database.

Returns a complete standardized response with all possible fields. Fields that don't exist in the database are returned as null.

Access Control:

Authenticated users can access their own audios
Admins can access all audios
Sample audios and shared audios are publicly accessible

get/v2/audios/{audio_id}

Path parameters

audio_idstring required

The unique ID of the audio.

Response

Successful Response

audio_durationnumber nullable

Audio duration in seconds

audio_model_idstring nullable

Model used for audio processing

average_audio_emotionsobject nullable

Average audio emotions

bulk_upload_idstring nullable

Bulk upload batch ID

created_atstring nullable

Creation timestamp

csv_analysis_urlstring nullable

CSV analysis file URL

descriptionstring nullable

Audio description

emotionsobject nullable

Overall audio emotions

idstring nullable

Unique audio identifier

media_sourcestring nullable

Source type: youtube, dropbox, public_url, file_upload

media_source_urlstring nullable

Original URL as provided

parent_idstring nullable

Parent video ID if extracted from video

predefined_qaobject[] nullable

Predefined Q&A analysis

project_idstring nullable

Associated project ID. Empty/absent for library audio.

project_typestring nullable

Type of the associated project (sales_deal/...). Null for library audio.

psychologist_reviewstring nullable

Psychologist review content

psychologist_review_statusstring nullable

Psychologist review status

segment_audio_emotionsobject[] nullable

Segment-level audio emotions

segment_text_emotionsobject[] nullable

Segment-level text emotions

share_statusboolean nullable

Whether audio is shared

diarizationboolean nullable

Whether diarization is enabled (defaults to true if absent from the stored document)

has_transcriptboolean nullable

Whether a transcript exists (or is being produced): our ASR ran, OR one was supplied and applied. Drive the transcript UI off THIS, not transcription — an imported call has transcription=false and a real transcript, so that flag hides one that is right there.

text_speaker_id_overall_emotionsobject[] nullable

Speaker-level aggregated emotions

speakersobject[] nullable

Identified speakers

statusstring nullable

Processing status

system_namestring nullable

System name that processed the audio

tags_mapobject nullable

Tags map for categorization

text_emotionboolean nullable

Whether text emotion analysis was enabled at upload time (defaults to true if absent from the stored document)

text_overall_emotionsobject nullable

Overall text emotions from transcript

text_idstring nullable

Associated text analysis ID

text_model_idstring nullable

Model used for text processing

titlestring nullable

Audio title

transcript_segmentsobject[] nullable

Transcript segments with emotions

transcriptionboolean nullable

Whether transcription/ASR was enabled at upload time (defaults to true if absent from the stored document)

ui_requestboolean nullable

Whether request came from UI

urlstring nullable

Original audio URL

user_idstring nullable

Owner user ID

video_idstring nullable

Associated video ID if extracted from video

text_word_countinteger nullable

Word count of transcript

youtube_urlstring nullable

YouTube URL if applicable