+1 (831) 222-8398
Sign Up
Log In
Place your order
Transcription and translation services online Transcription and translation services online
Sign Up
Log In
Place your order

Transcription API (v4)

Introduction

Using GoTranscript API you can submit files for:

  • transcription (audio/video files)
  • translation (documents/audio/video files)
  • captioning (audio/video files)
  • subtitling (audio/video files)

How it works?

workflow
  • 1. Your server sends url of a file you want to transcribe.
  • 2. When transcription is finished, GoTranscript will send url of transcription back to you.

When you will make an order, money will be deducted from your GoTranscript wallet.

Authentication

Authentication is done with an api_token parameter given in the request body.
Your api_token is: login_to_see_token

HTTP Statuses

if returned status code is 200, it indicates that the request was fulfilled successfully and that no error was encountered.

if you receive a status code 400, it typically indicate that there was an issue with the request that was sent. Among other things, this could mean that you did not authenticate correctly, or that your request is malformed.

Return codes in the 500 range typically indicate that there is a server-side problem. This means that we are having an issue on our end and cannot fulfill your request currently.

Responses

When a request is successful, a response body will typically be sent back in the form of a JSON object. Please take a look at API calls to see what data object will be given. In case of error, standard response object will be given:


// HTTP 400 Bad Request Error Response
{
    'mode' => 'string',
    'status' => 'string',
    'error' => 'string'
}

Callbacks

GoTranscript uses callbacks to notify your application when your requested job is done. With every API request, an additional callback_url parameter can be given. The value of this parameter must be a valid HTTP URL address, which must be able to handle POST requests.

Set your website url down below.

In case you dont want to pass callback_url parameter in every API call, you can set it globally here:

Login to set global callback URL

When your application receives a callback, it must respond with the string ok. If the response is not ok, the request will be retried up to a maximum of 10 attempts, with random time intervals between each attempt.

Transcription

Send POST request to GoTranscript to order transcription.

Request example

https://gotranscript.com/api/v4/transcriptions?mode=test&api_token=login_to_see_token&url=https://gotranscript.com/tests/api/audio.mp3&language=english

    curl -X POST \
      -H "Content-Type: application/json" \
      -d '{"mode":"test", "url": "https://gotranscript.com/tests/api/audio.mp3", "language": "english", "api_token": "login_to_see_token"}' \
      "https://gotranscript.com/api/v4/transcriptions"
                            

    $curl = curl_init();

    curl_setopt_array($curl, [
      CURLOPT_URL => 'https://gotranscript.com/api/v4/transcriptions',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'POST',
      CURLOPT_POSTFIELDS => json_encode(
        [
            'mode' => 'test',
            'url' => 'https://gotranscript.com/tests/api/audio.mp3', // your file url
            'language' => 'english',
            'api_token' => 'login_to_see_token', // this is your API token
        ]
      ),
      CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
      ]
    ]);

    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);

    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
                            

    import requests

    endpoint = "https://gotranscript.com/api/v4/transcriptions"

    json = {
        'mode': 'test',
        'url': 'https://gotranscript.com/tests/api/audio.mp3',
        'language': 'english',
        'api_token': 'login_to_see_token',
    }

    headers = {
      "Content-Type": "application/json"
    }

    response = requests.post(endpoint, json=json, headers=headers)
    parse(response)
                            

    const axios = require("axios");

    const assembly = axios.create({
      baseURL: "https://gotranscript.com",
      headers: {
        "Content-Type": "application/json"
      }
    });

    assembly
      .post("/api/v4/transcriptions", {
        mode: "test",
        url: "https://gotranscript.com/tests/api/audio.mp3",
        language: "english",
        api_token: "login_to_see_token"
      })
      .then(parseResponse)
      .catch(console.error);

Request parameters

Name Type Description
api_token String Your API token. Your current API token is: login_to_see_token
mode String Can be one of the following: test, live. When set to test, file price is calculated but not charged from your wallet. This way you can test how much it will cost to make an order. When you want to make a real order, change test to live.
url String File url you want to transcribe.
language String Language of file. List of available languages: english,arabic,bosnian,catalan,chinese-simplified,chinese-traditional,croatian,dutch,filipino,french,german,hebrew,indonesian,italian,japanese,korean,lithuanian,persian-dari,persian-farsi,portuguese,russian,serbian,spanish,swahili,swedish,turkish,vietnamese.
comment String Here you can specify names of speakers or other information for transcribers.
from Integer Start file transcription from this amount of seconds.
till Integer Finish file transcription at this amount of seconds.
text_format String Available values: clean_verbatim (default), full_verbatim
timestamping String Available values: not_required (default), every_10_seconds , every_30_seconds , every_2_minutes , change_of_speaker
turnaround_time String Available values: 12_hours, 1_days, 3_days, 5_days (default).
The following languages supports only 5_days value: bosnian,catalan,croatian,filipino,hebrew,indonesian,lithuanian,persian (dari),persian (farsi),portuguese,russian,serbian,swahili,swedish,turkish,vietnamese.
number_of_speakers String Available values: 1_or_2 (default), 3_or_more
callback_url String When order is finished, you can specify url which will be used for callback.

Response body

Response will be in JSON format.


    {
       "mode":"live",
       "status":"success",
       "order_id":123, // order_id will be set only when wallet is charged (live mode)
       "order_total":12.34 // $12.34 dollars
       "seconds":68, // order duration in seconds
       "in_wallet":0, // how much money you have left in your GoTranscript wallet
       "delivery_estimate":"2023-10-04 09:41:16", // (UTC time)
    }

Callback

When file transcription is finished, POST request will be sent to your specified URL. It will contain JSON:


    {
        'mode' => 'live',
        'order_id' => 123,
        'transcription_url' => 'https://gotranscript.com/api/v4/test-file/transcriptions?api_token=login_to_see_token',
        'language' => 'english', // language of transcription
    }

Transcription file format. transcription_url returns .docx document. You can also get transcription in different formats by adding parameter to transcription_url: docx, doc, pdf, text, html or json
Example: https://gotranscript.com/api/v4/test-file/transcriptions?api_token=login_to_see_token&format=json

To test how your server responds to request from gotranscript.com, click on the link below.

Send test response to your server

Translation

Send POST request to GoTranscript to order translation.

Request example

https://gotranscript.com/api/v4/translations?mode=test&api_token=login_to_see_token&url=https://gotranscript.com/tests/api/audio.mp3&translate_from=english&translate_to=german

    curl -X POST \
      -H "Content-Type: application/json" \
      -d '{"mode":"test", "url": "https://gotranscript.com/tests/api/audio.mp3", "translate_from": "english", "translate_to": "german", "api_token": "login_to_see_token"}' \
      "https://gotranscript.com/api/v4/translations"
                            

    $curl = curl_init();

    curl_setopt_array($curl, [
      CURLOPT_URL => 'https://gotranscript.com/api/v4/translations',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'POST',
      CURLOPT_POSTFIELDS => json_encode(
        [
            'mode' => 'test',
            'url' => 'https://gotranscript.com/tests/api/audio.mp3', // your file url
            'translate_from' => 'english',
            'translate_to' => 'german',
            'api_token' => 'login_to_see_token', // this is your API token
        ]
      ),
      CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
      ]
    ]);

    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);

    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
                            

    import requests

    endpoint = "https://gotranscript.com/api/v4/translations"

    json = {
        'mode': 'test',
        'url': 'https://gotranscript.com/tests/api/audio.mp3',
        'translate_from': 'english',
        'translate_to': 'german',
        'api_token': 'login_to_see_token',
    }

    headers = {
      "Content-Type": "application/json"
    }

    response = requests.post(endpoint, json=json, headers=headers)
    parse(response)
                            

    const axios = require("axios");

    const assembly = axios.create({
      baseURL: "https://gotranscript.com",
      headers: {
        "Content-Type": "application/json"
      }
    });

    assembly
      .post("/api/v4/translations", {
        mode: "test",
        url: "https://gotranscript.com/tests/api/audio.mp3",
        translate_from: "english",
        translate_to: "german",
        api_token: "login_to_see_token"
      })
      .then(parseResponse)
      .catch(console.error);

Request parameters

Name Type Description
api_token String Your API token. Your current API token is: login_to_see_token
mode String Can be one of the following: test, live. When set to test, file price is calculated but not charged from your wallet. This way you can test how much it will cost to make an order. When you want to make a real order, change test to live.
url String File url you want to translate.
translate_from String Translate from the given file text language. List of available languages: english,albanian,arabic,azerbaijani,bengali,bosnian,bulgarian,catalan,simplified-chinese,traditional-chinese,croatian,czech,danish,dutch,estonian,filipino,finnish,french,french-canadian,georgian,german,greek,hebrew,hungarian,indian-gujarati,indian-hindi,indian-tamil,indonesian,italian,japanese,korean,kurdish,kyrgyz,latvian,lithuanian,macedonian,malay,nepali,norwegian,pashto,persian-farsi,polish,portuguese-brazil,portuguese-portugal,romanian,russian,serbian,slovak,slovenian,somali,spanish-latin,spanish,swahili,swedish,thai,turkish,ukrainian,urdu,vietnamese.
translate_to String Translate the given file text to a given language. List of available languages: english,albanian,arabic,azerbaijani,bengali,bosnian,bulgarian,catalan,simplified-chinese,traditional-chinese,croatian,czech,danish,dutch,estonian,filipino,finnish,french,french-canadian,georgian,german,greek,hebrew,hungarian,indian-gujarati,indian-hindi,indian-tamil,indonesian,italian,japanese,korean,kurdish,kyrgyz,latvian,lithuanian,macedonian,malay,nepali,norwegian,pashto,persian-farsi,polish,portuguese-brazil,portuguese-portugal,romanian,russian,serbian,slovak,slovenian,somali,spanish-latin,spanish,swahili,swedish,thai,turkish,ukrainian,urdu,vietnamese.
comment String Here you can specify additional information for translators.
callback_url String When order is finished, you can specify url which will be used for callback.

Response body

Response will be in JSON format.


    {
       "mode":"live",
       "status":"success",
       "order_id":123, // order_id will be set only when wallet is charged (live mode)
       "order_total":12.34 // $12.34 dollars
       "seconds":0, // order duration in seconds
       "words":68, // order word count
       "in_wallet":0, // how much money you have left in your GoTranscript wallet
       "delivery_estimate":"2023-10-04 09:41:16", // (UTC time)
    }

Callback

When file transcription is finished, POST request will be sent to your specified URL. It will contain JSON:


    {
        'mode' => 'live',
        'order_id' => 123,
        'translation_url' => 'https://gotranscript.com/api/v4/test-file/translations?api_token=login_to_see_token'
    }

To test how your server responds to request from gotranscript.com, click on the link below.

Send test response to your server

Captions Example

Send POST request to GoTranscript to order captions.

Request example

https://gotranscript.com/api/v4/captions?mode=test&api_token=login_to_see_token&url=https://gotranscript.com/tests/api/audio.mp3&language=english

    curl -X POST \
      -H "Content-Type: application/json" \
      -d '{"mode":"test", "url": "https://gotranscript.com/tests/api/audio.mp3", "language": "english", "api_token": "login_to_see_token"}' \
      "https://gotranscript.com/api/v4/captions"
                            

    $curl = curl_init();

    curl_setopt_array($curl, [
      CURLOPT_URL => 'https://gotranscript.com/api/v4/captions',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'POST',
      CURLOPT_POSTFIELDS => json_encode(
        [
            'mode' => 'test',
            'url' => 'https://gotranscript.com/tests/api/audio.mp3', // your file url
            'language' => 'english',
            'api_token' => 'login_to_see_token', // this is your API token
        ]
      ),
      CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
      ]
    ]);

    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);

    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
                            

    import requests

    endpoint = "https://gotranscript.com/api/v4/captions"

    json = {
        'mode': 'test',
        'url': 'https://gotranscript.com/tests/api/audio.mp3',
        'language': 'english',
        'api_token': 'login_to_see_token',
    }

    headers = {
      "Content-Type": "application/json"
    }

    response = requests.post(endpoint, json=json, headers=headers)
    parse(response)
                            

    const axios = require("axios");

    const assembly = axios.create({
      baseURL: "https://gotranscript.com",
      headers: {
        "Content-Type": "application/json"
      }
    });

    assembly
      .post("/api/v4/captions", {
        mode: "test",
        url: "https://gotranscript.com/tests/api/audio.mp3",
        language: "english",
        api_token: "login_to_see_token"
      })
      .then(parseResponse)
      .catch(console.error);

Request parameters

Name Type Description
api_token String Your API token. Your current API token is: login_to_see_token
mode String Can be one of the following: test, live. When set to test, file price is calculated but not charged from your wallet. This way you can test how much it will cost to make an order. When you want to make a real order, change test to live.
url String File url you want to make captions for.
language String Language of file. List of available languages: english,arabic,bosnian,catalan,chinese-simplified,chinese-traditional,croatian,dutch,filipino,french,german,hebrew,indonesian,italian,japanese,korean,lithuanian,persian-dari,persian-farsi,portuguese,russian,serbian,spanish,swahili,swedish,turkish,vietnamese.
comment String Here you can specify names of speakers or other information for subtitlers.
from Integer Start file transcription from this amount of seconds.
till Integer Finish file transcription at this amount of seconds.
text_format String Available values: clean_verbatim (default), full_verbatim
timestamping String Available values: not_required (default), every_10_seconds , every_30_seconds , every_2_minutes , change_of_speaker
turnaround_time String Available values: 12_hours, 1_days, 3_days, 5_days (default).
The following languages supports only 5_days value: bosnian,catalan,croatian,filipino,hebrew,indonesian,lithuanian,persian (dari),persian (farsi),portuguese,russian,serbian,swahili,swedish,turkish,vietnamese.
number_of_speakers String Available values: 1_or_2 (default), 3_or_more
callback_url String When order is finished, you can specify url which will be used for callback.

Response body

Response will be in JSON format.


    {
       "mode":"live",
       "status":"success",
       "order_id":123, // order_id will be set only when wallet is charged (live mode)
       "order_total":12.34 // $12.34 dollars
       "seconds":68, // order duration in seconds
       "in_wallet":0, // how much money you have left in your GoTranscript wallet
       "delivery_estimate":"2023-10-04 09:41:16", // (UTC time)
    }

Callback

When file transcription is finished, POST request will be sent to your specified URL. It will contain JSON:


    {
        'mode' => 'live',
        'order_id' => 123,
        'captions_url' => 'https://gotranscript.com/api/v4/test-file/captions?api_token=login_to_see_token',
        'transcription_url' => 'https://gotranscript.com/api/v4/test-file/transcriptions?api_token=login_to_see_token',
        'language' => 'english' // language of captions
    }

To test how your server responds to request from gotranscript.com, click on the link below.

Send test response to your server

Subtitles Example

Send POST request to GoTranscript to order subtitles.

Request example

https://gotranscript.com/api/v4/subtitles?mode=test&api_token=login_to_see_token&url=https://gotranscript.com/tests/api/audio.mp3&translate_from=english&translate_to=german

    curl -X POST \
      -H "Content-Type: application/json" \
      -d '{"mode":"test", "url": "https://gotranscript.com/tests/api/audio.mp3", "translate_from": "english", "translate_to": "german", "api_token": "login_to_see_token"}' \
      "https://gotranscript.com/api/v4/subtitles"
                            

    $curl = curl_init();

    curl_setopt_array($curl, [
      CURLOPT_URL => 'https://gotranscript.com/api/v4/subtitles,
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'POST',
      CURLOPT_POSTFIELDS => json_encode(
        [
            'mode' => 'test',
            'url' => 'https://gotranscript.com/tests/api/audio.mp3', // your file url
            'translate_from' => 'english',
            'translate_to' => 'german',
            'api_token' => 'login_to_see_token', // this is your API token
        ]
      ),
      CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
      ]
    ]);

    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);

    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
                            

    import requests

    endpoint = "https://gotranscript.com/api/v4/subtitles"

    json = {
        'mode': 'test',
        'url': 'https://gotranscript.com/tests/api/audio.mp3',
        'translate_from': 'english',
        'translate_to': 'german',
        'api_token': 'login_to_see_token',
    }

    headers = {
      "Content-Type": "application/json"
    }

    response = requests.post(endpoint, json=json, headers=headers)
    parse(response)
                            

    const axios = require("axios");

    const assembly = axios.create({
      baseURL: "https://gotranscript.com",
      headers: {
        "Content-Type": "application/json"
      }
    });

    assembly
      .post("/api/v4/subtitles", {
        mode: "test",
        url: "https://gotranscript.com/tests/api/audio.mp3",
        translate_from: "english",
        translate_to: "german",
        api_token: "login_to_see_token"
      })
      .then(parseResponse)
      .catch(console.error);

Request parameters

Name Type Description
api_token String Your API token. Your current API token is: login_to_see_token
mode String Can be one of the following: test, live. When set to test, file price is calculated but not charged from your wallet. This way you can test how much it will cost to make an order. When you want to make a real order, change test to live.
url String File url you want to make subtitles for.
translate_from String Language of file. List of available languages: english,albanian,arabic,azerbaijani,bengali,bosnian,bulgarian,catalan,simplified-chinese,traditional-chinese,croatian,czech,danish,dutch,estonian,filipino,finnish,french,french-canadian,georgian,german,greek,hebrew,hungarian,indian-gujarati,indian-hindi,indian-tamil,indonesian,italian,japanese,korean,kurdish,kyrgyz,latvian,lithuanian,macedonian,malay,nepali,norwegian,pashto,persian-farsi,polish,portuguese-brazil,portuguese-portugal,romanian,russian,serbian,slovak,slovenian,somali,spanish-latin,spanish,swahili,swedish,thai,turkish,ukrainian,urdu,vietnamese.
translate_to String Subtitle the given file to a given language. List of available languages: english,albanian,arabic,azerbaijani,bengali,bosnian,bulgarian,catalan,simplified-chinese,traditional-chinese,croatian,czech,danish,dutch,estonian,filipino,finnish,french,french-canadian,georgian,german,greek,hebrew,hungarian,indian-gujarati,indian-hindi,indian-tamil,indonesian,italian,japanese,korean,kurdish,kyrgyz,latvian,lithuanian,macedonian,malay,nepali,norwegian,pashto,persian-farsi,polish,portuguese-brazil,portuguese-portugal,romanian,russian,serbian,slovak,slovenian,somali,spanish-latin,spanish,swahili,swedish,thai,turkish,ukrainian,urdu,vietnamese.
comment String Here you can specify additional information for subtitles.
callback_url String When order is finished, you can specify url which will be used for callback.

Response body

Response will be in JSON format.


    {
       "mode":"live",
       "status":"success",
       "order_id":123, // order_id will be set only when wallet is charged (live mode)
       "order_total":12.34 // $12.34 dollars
       "seconds":0, // order duration in seconds
       "in_wallet":0, // how much money you have left in your GoTranscript wallet
       "delivery_estimate":"2023-10-04 09:41:16", // (UTC time)
    }

Callback

When file transcription is finished, POST request will be sent to your specified URL. It will contain JSON:


    {
        'mode' => 'live',
        'order_id' => 123,
        'subtitles_url' => 'https://gotranscript.com/api/v4/test-file/subtitles?api_token=login_to_see_token'
    }

To test how your server responds to request from gotranscript.com, click on the link below.

Send test response to your server

Get list of Orders

Send GET request to GoTranscript to get list of orders.

Request example

https://gotranscript.com/api/v4/orders?mode=test&api_token=login_to_see_token

    curl -X GET \
      -H "Content-Type: application/json" \
      "https://gotranscript.com/api/v4/orders?mode=test&api_token=login_to_see_token"
            

    $curl = curl_init();

    curl_setopt_array($curl, [
      CURLOPT_URL => 'https://gotranscript.com/api/v4/orders?mode=test&api_token=login_to_see_token',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
      ]
    ]);

    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);

    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
            

    import requests

    endpoint = "https://gotranscript.com/api/v4/orders?mode=test&api_token=login_to_see_token"

    headers = {
      "Content-Type": "application/json"
    }

    response = requests.get(endpoint, headers=headers)
    parse(response)
            

    const axios = require("axios");

    const assembly = axios.create({
      baseURL: "https://gotranscript.com",
      headers: {
        "Content-Type": "application/json"
      }
    });

    assembly
      .get("/api/v4/orders?mode=test&api_token=login_to_see_token")
      .then(parseResponse)
      .catch(console.error);

Query parameters

Name Type Description
api_token String Your API token. Your current API token is: login_to_see_token
mode String Can be one of the following: live.
cursor String This field is used to paginate results. The cursor parameter will be automatically filled in the next_page_url.

Response body

Name Type Description
id Integer Order ID.
type String Can be one of the following: transcriptions, captions, translations, subtitles.
price Float Amount of money paid for order in USD.
paid_at String or null The date and time the order was paid in UTC time. Null value if order is not paid yet.
delivery_estimate String The date and time the order should be done in UTC time. Null value if order is not paid yet.
finished_at String or null The date and time the order was finished in UTC time. Null value if order is not finished yet.
comment String User comment passed as an argument.
seconds Integer Total duration of the order's audio files (in seconds).
words Integer Total number of words in the order's documents.
translate_from String Translate from the given file text language. Value passed as an argument with translation or subtitle order.
translate_to String Translate the given file text to a given language. Value passed as an argument with translation or subtitles order.
language String Language of file. Value passed via language argument. Value passed as an argument with transcription or captions order.
text_format String Value passed as an argument with transcription or captions order.
timestamping String Value passed as an argument with transcription or captions order.
turnaround_time String Value passed as an argument with transcription or captions order.
number_of_speakers String Value passed as an argument with transcription or captions order.
transcription_url String Transcription file url, will be served after order is finished.
captions_url String Captions file url, will be served after order is finished.
translation_url String Translations file url, will be served after order is finished.
subtitles_url String Subtitles file url, will be served after order is finished.

Response will be in JSON format.


    {
      "orders": [
        {
          "id": 1,
          "type": "captions",
          "price": 1.21,
          "paid_at": "2022-11-20 21:00:00",
          "delivery_estimate": "2022-11-20 21:00:00",
          "finished_at": "2022-11-20 21:00:00",
          "comment": "Speaker names: John and Dave",
          "seconds": 1000,
          "words": 0,
          "language": "english",
          "text_format": "clean_verbatim",
          "timestamping": "not_required",
          "turnaround_time": "days_3",
          "number_of_speakers": "1_or_2",
          "captions_url": "https://gotranscript.com/api/v4/orders/1/captions?api_token=login_to_see_token"
        },
        ...
      ],
      "next_page_url": https://gotranscript.com/api/v4/orders?mode=test&api_token=login_to_see_token&cursor=string
    }

Get Order by ID

Send GET request to GoTranscript to get order.

Request example

https://gotranscript.com/api/v4/orders/your_order_ID?mode=test&api_token=login_to_see_token

    curl -X GET \
      -H "Content-Type: application/json" \
      "https://gotranscript.com/api/v4/orders/your_order_ID?mode=test&api_token=login_to_see_token"
            

    $curl = curl_init();

    curl_setopt_array($curl, [
      CURLOPT_URL => 'https://gotranscript.com/api/v4/orders/your_order_ID?mode=test&api_token=login_to_see_token',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => [
        'Content-Type: application/json'
      ]
    ]);

    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);

    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
            

    import requests

    endpoint = "https://gotranscript.com/api/v4/orders/your_order_ID?mode=test&api_token=login_to_see_token"

    headers = {
      "Content-Type": "application/json"
    }

    response = requests.get(endpoint, headers=headers)
    parse(response)
            

    const axios = require("axios");

    const assembly = axios.create({
      baseURL: "https://gotranscript.com",
      headers: {
        "Content-Type": "application/json"
      }
    });

    assembly
      .get("/api/v4/orders/your_order_ID?mode=test&api_token=login_to_see_token")
      .then(parseResponse)
      .catch(console.error);

Query parameters

Name Type Description
api_token String Your API token. Your current API token is: login_to_see_token
mode String Can be one of the following: live.

Response body

Order response description can be found here.

Response will be in JSON format.


    {
      "data": {
        "id": 1,
        "type": "captions",
        "price": 1.21,
        "paid_at": "2022-11-20 21:00:00",
        "delivery_estimate": "2022-11-20 21:00:00",
        "finished_at": "2022-11-20 21:00:00",
        "comment": "Speaker names: John and Dave",
        "seconds": 1000,
        "words": 0,
        "language": "english",
        "text_format": "clean_verbatim",
        "timestamping": "not_required",
        "turnaround_time": "days_3",
        "number_of_speakers": "1_or_2",
        "captions_url": "https://gotranscript.com/api/v4/orders/1/captions?api_token=login_to_see_token"
        ]
      }
    }

Other

Monitoring Orders

When api is used in live mode (not in testing), you can go to login. There you will see your orders and their statuses.

Updates to downloaded files

After an order is finished, some file are randomly selected to check their quality. When errors are found, they are fixed and one more request is sent to your specified API url. This request looks the same as original. It can be ignored if you already downloaded the file or you can redownload the file to get a version with fixed errors.

Different file types can return different callback data, please take a look at every API Callback object section.

Need help? Contact us: info@gotranscript.com

Get In Touch
+1 (831) 222-8398
Contact us form
hipaa
Join us as a transcriber
facebook
linkedin
twitter
About us
Blog
Privacy
Check reviews
“ One of the bigger advantages of choosing GoTranscript is that it can cater for the more complex projects you may need to handle ”
By Jonas DeMuro and Brian Turner
March 07, 2022
“ The human transcribers at GoTranscript returned nearly 100% accurate transcriptions in a couple of days and didn’t balk at recordings featuring heavy accents. ”
By Signe Brewster
June 30, 2020
“ Many podcasters use transcription services like GoTranscript to create written records of their broadcasts. ”
By Andrew Arnold
Jul 26, 2021
Check reviews from our clients
4.9
Site rating
star
Filter by:
star star star star star 2923
star star star star 480
star star star 42
star star 5
star 2
4.9
Site rating
star
1/663
verified Verified Order
star star star star star
“ As a doctoral candidate with dyslexia, this service has been a lifesaver during my dissertation. ”
Yvette Regalado
Sep 29, 2023
verified Verified Order
star star star star
“ Was positively surprised by the speed in which the order was completed. Received transcriptions of 6 interviews, 1h each, over night. Wow. Quality was good, too. Thanks. ”
florian
Sep 29, 2023
verified Verified Order
star star star star star
“ I was very pleased with this service. I have tried AI services, and they just are not as clear. GoTranscript was able to sort out the speakers names, which absolutely surprised me. This and future GoTranscript transcriptions will lay a foundation of the clear content I need for the books I produce. ”
Oleah Morris, Royal Memoir at royalmemoir.com
Sep 27, 2023
verified Verified Order
star star star star star
“ Go Transcript is consistently the fastest and most accurate transcription service I have used. Easy interface and documents. ”
David
Sep 27, 2023