SPspeechmatics

Get the transcript for a transcription job

get/jobs/{jobid}/transcript

Request

Path parameters

jobidstring required

ID of the job.

Query parameters

format'json-v2' | 'txt' | 'srt'

The transcription format (by default the json-v2 format is returned).

waitinteger

Note: Only available on SaaS on Cloud. Number of seconds to block until the transcript is ready before responding. Capped server-side. Returns HTTP 200 with the transcript if it becomes ready within wait; otherwise returns the usual HTTP 404, and you can retry to keep waiting. When omitted, a short default wait applies: currently 5 seconds, and it will increase. Treat the default as an unspecified short interval rather than a fixed duration. Pass wait=0 to respond immediately.

Response

OK

formatstring required

Speechmatics JSON transcript format version number.

translationsobject

Translations of the transcript into other languages. It is a map of ISO language codes to arrays of translated sentences. Configured using translation_config.

Example response

{
  "format": "2.1",
  "job": {
    "created_at": "2018-01-09T12:29:01.853047Z",
    "id": "a1b2c3d4e5",
    "tracking": {
      "title": "ACME Q12018 Earnings Call",
      "reference": "/data/clients/ACME/statements/segs/2018Q1-seg8",
      "tags": [
        "quick-review",
        "segment"
      ],
      "details": {
        "client": "ACME Corp",
        "segment": 8,
        "seg_start": 963.201,
        "seg_end": 1091.481
      }
    }
  },
  "metadata": {
    "created_at": "2018-01-09T12:29:01.853047Z",
    "transcription_config": {
      "language": "en",
      "output_locale": "en-GB",
      "additional_vocab": [
        {
          "content": "Speechmatics",
          "sounds_like": [
            "speechmatics"
          ]
        },
        {
          "content": "gnocchi",
          "sounds_like": [
            "nyohki",
            "nokey",
            "nochi"
          ]
        },
        {
          "content": "CEO",
          "sounds_like": [
            "C.E.O."
          ]
        },
        {
          "content": "financial crisis"
        }
      ],
      "diarization": "channel",
      "channel_diarization_labels": [
        "Caller",
        "Agent"
      ]
    },
    "language_identification": {
      "results": [
        {
          "alternatives": [
            {
              "language": "en",
              "confidence": 0.98
            },
            {
              "language": "fr",
              "confidence": 0.02
            }
          ],
          "start_time": 0,
          "end_time": 5.5
        },
        {
          "alternatives": [
            {
              "language": "en",
              "confidence": 0.95
            },
            {
              "language": "fr",
              "confidence": 0.05
            }
          ],
          "start_time": 5.6,
          "end_time": 10
        }
      ]
    }
  },
  "translations": {
    "de": [
      {
        "start_time": 0.5,
        "end_time": 1.3,
        "content": "Guten Tag, wie geht es dir?",
        "speaker": "UU"
      }
    ],
    "fr": [
      {
        "start_time": 0.5,
        "end_time": 1.3,
        "content": "Bonjour, comment ça va?",
        "speaker": "UU"
      }
    ]
  },
  "summary": {
    "content": "this is a summary"
  },
  "sentiment_analysis": {
    "segments": [
      {
        "text": "I am happy with the product.",
        "start_time": 0,
        "end_time": 5,
        "sentiment": "positive",
        "speaker": "John Doe",
        "channel": "Chat",
        "confidence": 0.9
      },
      {
        "text": "I don't like the customer service.",
        "start_time": 6,
        "end_time": 12,
        "sentiment": "negative",
        "speaker": "John Doe",
        "channel": "Chat",
        "confidence": 0.8
      }
    ],
    "summary": {
      "overall": {
        "positive_count": 1,
        "negative_count": 1,
        "neutral_count": 0
      },
      "speakers": [
        {
          "speaker": "John Doe",
          "positive_count": 1,
          "negative_count": 1,
          "neutral_count": 0
        }
      ],
      "channels": [
        {
          "channel": "Chat",
          "positive_count": 1,
          "negative_count": 1,
          "neutral_count": 0
        }
      ]
    }
  },
  "topics": {
    "segments": [
      {
        "text": "I am happy with the product.",
        "start_time": 0,
        "end_time": 5,
        "topics": [
          {
            "topic": "product"
          }
        ]
      },
      {
        "text": "We will deploy this container for Spanish.",
        "start_time": 6,
        "end_time": 12,
        "topics": [
          {
            "topic": "deployment"
          },
          {
            "topic": "languages"
          }
        ]
      }
    ],
    "summary": {
      "overall": {
        "deployment": 1,
        "languages": 1,
        "product": 1
      }
    }
  },
  "chapters": [
    {
      "title": "Part 1",
      "summary": "Summary of part 1",
      "start_time": 0,
      "end_time": 5
    },
    {
      "title": "Part 2",
      "summary": "Summary of part 2",
      "start_time": 5,
      "end_time": 10
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.