Using this transcription API you can submit files for:
When you will make an order, money will be deducted from your GoTranscript wallet.
When order will be finished, we will send POST request to your specified url.
Set your website url down below.
login to see formSend POST request to GoTranscript to order transcription.
<?php $url = 'https://gotranscript.com/api/v4/transcriptions'; $data = [ '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 ]; echo curlPost($url, $data); // function definition can be found at the bottom of documentation
You can pass additional parameters:
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 }
When file will be finished, POST request will be sent to your specified URL. It will contain this data:
{ '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 }
When your server receives data, it must output ok. If it will not output ok, we will send this request again every hour up to 10 times.
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 (note: json format for files with text direction RTL is experimental and might contain some inaccuracies. For RTL files it is recommended to use docx).
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 serverSend POST request to GoTranscript to order translation.
<?php $url = 'https://gotranscript.com/api/v4/translations'; $data = [ '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 ]; echo curlPost($url, $data); // function definition can be found at the bottom of documentation
You can pass additional parameters:
Response will be in JSON format. You will get order_id and order_total.
{ "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 }
When file will be finished, POST request will be sent to your specified URL. It will contain this data:
{ 'mode' => 'live', 'order_id' => 123, 'translation_url' => 'https://gotranscript.com/api/v4/test-file/translations?api_token=login_to_see_token', }
When your server receives data, it must output ok. If it will not output ok, we will send this request again every hour up to 10 times.
To test how your server responds to request from gotranscript.com, click on the link below.
Send test response to your serverSend POST request to GoTranscript to order captions.
<?php $url = 'https://gotranscript.com/api/v4/captions'; $data = [ '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 ]; echo curlPost($url, $data); // function definition can be found at the bottom of documentation
You can pass additional parameters:
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 }
When file will be finished, POST request will be sent to your specified URL. It will contain this data:
{ '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 }
When your server receives data, it must output ok. If it will not output ok, we will send this request again every hour up to 10 times.
To test how your server responds to request from gotranscript.com, click on the link below.
Send test response to your serverSend POST request to GoTranscript to order subtitles.
<?php $url = 'https://gotranscript.com/api/v4/subtitles'; $data = [ '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 ]; echo curlPost($url, $data); // function definition can be found at the bottom of documentation
You can pass additional parameters:
Response will be in JSON format. You will get order_id and order_total.
{ "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 }
When file will be finished, POST request will be sent to your specified URL. It will contain this data:
{ 'mode' => 'live', 'order_id' => 123, 'subtitles_url' => 'https://gotranscript.com/api/v4/test-file/subtitles?api_token=login_to_see_token', }
When your server receives data, it must output ok. If it will not output ok, we will send this request again every hour up to 10 times.
To test how your server responds to request from gotranscript.com, click on the link below.
Send test response to your serverThis is curlPost() function that sends POST request using CURL. It is used in examples.
function curlPost($url, array $data) { $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); $response = curl_exec($ch); if ($response === false) { throw new \Exception(curl_error($ch)); } curl_close($ch); return $response; }
When api is used in live mode (not in testing), you can go to login. There you will see your orders and their statuses.
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.
All orders made through this transcription API receive 20% discount.