We appreciate you contacting us. One of our colleagues will get back to you shortly. Have a great day!
Hippo Video API combines a well-scoped feature set for both users and developers. The following are the benefits and features that come with our embeddable API.
Benefits of Using Our API
Easily Embeddable
Hippo Video offers you a seamless API integration. The Embed Button works with any web page, blog or publishing platform. All you need to have is a browser extension and a simple code to get things started.
White Label API
Display your brand on our player. Your users will only see your brand in their entire experience with the API recorder.
Reliable & Affordable
Hippo Video is a powerhouse that can hold thousands of videos providing the needed stability for its users. The Video/Screen Recorder API is highly affordable.
Customizable API Button & Callback Events
The API Button is designed to fit all styles. That’s why we built customizable buttons for your convenience. You can now modify the API’s theme and its view, to suit your brand.
We send callback events to improve your user’s experience whenever they take specific action on the API button.
FEATURES
Supports Screen, Audio, and Webcam Capture
Video can be easily created with multiple inputs. Hippo Video recorder API comes with the screen, audio, and webcam recording options. Your viewers can choose the inputs before they start recording a video.
Easily Embeddable
Hippo Video offers you a seamless API integration. The Embed Button works with any web page, blog or publishing platform. All you need to have is a browser extension and a simple code to get things started.
Instant Video Playback & Editing
We guarantee your viewers get the freedom to playback their video once they finish recording.
Never compromise in video editing. Hippo Video offers your viewers with editing options like trim, crop, frame resizing, adding text, smileys, callouts, and more! This helps your viewers to send you the edited videos after perfecting it.
It’s easy to get started, Follow these simple steps, and you'll have the embeddable API set up in no time.
Login to your Hippo Video account and go to the INTEGRATIONS page.
Click on the button near the Generic Embed Widget
Now copy the script code and place it inside the head tag. Preferably at the beginning, before all other scripts.
Copy the HTML code and place it wherever you want the video recording button to appear.
P.S: To record screen, you viewers need to have the Chrome Extension.
Getting the recorded video
The input element will contain the recorded video's URL after recording is finished.
Javascript API
OnLoad Callback
Place all your widget related code inside this callback
→ 'systemAudio' enables the system audio like any application or browser tab playing any music. You can also keep both the options enabled.
Stop Recording
Stops the on-going recording.
window.hippoWidget.stopRecording()
Import Video/Audio
Initiates media import.
window.hippoWidget.import()
Event Handling
window.hippoWidget.on(eventname, callback);
Available Events
EVENT
DESCRIPTION
DATA
record_initiated
When recording is initiated
preview_url: URL to preview video. (preview will be available at any point of time for the recorded user. For others, it will be the same as 'recorded_url')
recorded_url: video delivery URL. URL to share/mail/message others.
embed_url: similar to recorded_url. Optimized for embedding as an iframe in a website.
thumbnail_url: thumbnail URL of the video.
thumbnail_play_url: similar to 'thumbnail_url', except the play icon is displayed at the center.
token: video token for the recorded video.
asset_id: Hippo internal recording identifier.
record_started
When recording is started. (After user accept the permissions, etc.)
-
record_paused
When user pauses the recording
-
record_resumed
When user resumes the recording which is paused.
-
record_stopped
When user stops the recording
-
record_aborted
Same as 'video_cancelled'. Additionally, this event will also be triggered when a user aborts the recording while recording itself(future)
-
record_error
When there is some issue with recording
reason: Contains the error subtype. Will be one of the following,
NOTHING_RECORDED - When the user finished recording too soon, or before any data is available from the recording devices.
WEBCAM_PERMISSION_DENIED - When the user denies permission to record webcam
SCREEN_PERMISSION_DENIED - When the user denies permission to record screen
TAB_CANNOT_BE_RECORDED - Certain tabs like chrome tabs (chrome://), cannot be recorded. This state is sent when the user tries to do so.
CHROME_NOT_SUPPORTED - When the user tries to record in an old version of chrome which does not support screen recording.
CREATE_VIDEO_REQUEST_FAILED - This could be due to network issues when the request for creating a video from the client to the Hippo Video server fails.
PREPROCESS_FAILED - When Hippo Video is not able to preprocess the video.
PREPROCESS_REQUEST_FAILED - This could be due to network issues when the request for preprocessing the video from the client to the Hippo Video server fails.
NETWORK_ERROR - This occurs due to network issues.
NO_DATA_AVAILABLE - When no stream data is received from the user while screen recording.
error: detailed message for the error.
video_cancelled
When the user cancels submitting the recorded video
-
video_submitted
When the recorded video is submitted by the user
media_duration: duration of recorded/imported media in seconds.
import_progress
When import is in progress
operation: "started"/"uploading"progress : percentage of file uploaded from client (when operation = "uploading")
import_complete
When import is successful
preview_url: URL to preview video. (preview will be available at any point of time for the recorded user. For others, it will be the same as 'recorded_url')
share_url: video delivery URL. URL to share/mail/message others.
embed_url: same as recorded_url. optimized for embedding as an iframe in website.
thumbnail_url: thumbnail URL of the video.
thumbnail_play_url: same as 'thumbnail_url', but with play icon at the middle.
token: video token for the recorded video.
asset_id: Hippo internal recording identifier.
media_duration: duration of imported media in seconds.
import_failed
When import fails due to some error
reason: reason for error
source_uploaded
when the source media file(s) have been uploaded successfully to hippovideo servers. Once this event is triggered, it is guaranteed that there will be no data loss of the recorded or imported video.
-
Sample Page
You can also customize the button you want to be displayed on your page. Here are some sample pages: