Amara
Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.
Tools (30)
Add Subtitle Note
Adds a note/comment to a specific subtitle language for a video. Notes are used for collaboration and providing feedback on subtitles during the editing process. Requires a valid video ID and language code. Use this tool to document issues, provide suggestions, or communicate with other subtitle editors.
Inputs: body, video_id, language_code
Add Video URL
Tool to add a new URL to a video, allowing association with multiple video providers (YouTube, Vimeo, etc.). Use when you need to add alternative URLs for the same video content on different platforms.
Inputs: url, primary, video_id
Create Subtitle Language
Creates a new subtitle language track for an Amara video. This is the first step before adding or uploading subtitles - you must create the language track before you can add subtitle content. Each video can have multiple subtitle languages, but you cannot create the same language twice for the same video. Use list_subtitle_languages to check existing languages before creating a new one.
Inputs: language, video_id
Create Subtitles
Tool to create new subtitles for a video in a specific language. Accepts subtitle data in multiple formats (SRT, VTT, DFXP, etc.) either as a string or via URL. The subtitle language must already exist for the video - use create_subtitle_language first if needed. Use when you need to add subtitle content to a video.
Inputs: title, action, metadata, video_id, subtitles, sub_format, description, language_code, subtitles_url
Create Video
Tool to add a new video to Amara. Use when you need to create a video entry from a URL. Supports URLs from YouTube, Vimeo, Dailymotion, or direct video file URLs.
Inputs: team, title, project, duration, metadata, thumbnail, video_url, description, primary_audio_language_code
Delete Video URL
Tool to remove a video URL from a video. Use when you need to delete an unwanted or incorrect URL from a video's list of URLs. The video must have at least one other URL remaining.
Inputs: url_id, video_id
Fetch Subtitles Data
Fetch subtitle data for an Amara video in a specified language, returning text segments with start and end timestamps. Use a video ID and an available subtitle language code. JSON is the default; SRT and VTT downloads are not available through this tool.
Inputs: format, video_id, language_code
Get Activity
Tool to retrieve detailed information about a specific activity by its ID. Use when you need to fetch metadata for a particular activity event.
Inputs: activity_id
Get Subtitle Language Details
Tool to retrieve details for a single subtitle language. Use when you have video ID and language code and need metadata about that language track.
Inputs: video_id, language_code
Get Team Details
Tool to get details on a specific team by slug. Use when you need metadata for a single team.
Inputs: slug
Get Team Languages
Retrieves preferred and blacklisted language lists for a team by slug. A list may be empty if its linked resource is unavailable or cannot be parsed as a list.
Inputs: slug
Get User Activity
Tool to retrieve activity log for a specific user on Amara. Use when you need to view a user's recent actions such as video additions, subtitle edits, or comments. Returns a paginated list of activity items with details about what actions the user performed, on which videos, and in which languages.
Inputs: limit, offset, identifier
Get User Data
Retrieves detailed user profile information from Amara, including username, avatar, biography, languages spoken, and video counts. Use this tool when you need to: - Fetch a user's profile details by their username or user ID - Get information about the authenticated user using 'me' as identifier - Look up user metadata like languages, biography, or avatar - Obtain user resource URIs for further API operations Note: User IDs (with 'id$' prefix) are more reliable than usernames since usernames can be changed by users.
Inputs: identifier
Get Video URL
Tool to get details for a specific video URL. Use when you need to retrieve metadata about a specific URL entry in Amara's system by video_id and url_id.
Inputs: url_id, video_id
Get Video URL Details
Looks up an Amara video by public or embeddable video URL and returns metadata for the first matching video, including its ID, title, duration and thumbnail. It derives an embed URL for supported platforms when possible.
Inputs: url
List Activity
List a page of Amara activity with optional filters including team, video and activity type. If both team and video are supplied, the team filter takes precedence and video is ignored.
Inputs: team, type, after, limit, video, before, offset, language, team_activity
List Available Languages
Tool to get a list of all supported languages. Use when you need to know available language options from Amara.
List Subtitle Actions
Tool to list available actions for subtitles based on current workflow state. Use when you need to determine what operations can be performed on a subtitle (e.g., approve, reject, publish) for a specific video and language.
Inputs: video_id, language_code
List Subtitle Languages
List a page of subtitle languages for a video by video ID. The response includes pagination information.
Inputs: video_id
List Subtitle Notes
List a page of notes for a video's subtitle language, with pagination controls and response metadata.
Inputs: limit, offset, video_id, language_code
List Teams
Tool to list all teams. Use when you need to retrieve your accessible teams with pagination.
Inputs: limit, offset
List Video Activity
Tool to list activity for a specific video. Use when you need to fetch the activity log or history of actions performed on a video.
Inputs: limit, offset, video_id
List Videos
Lists videos in paginated results with optional filters. Without query parameters, Amara lists the last 20 public videos.
Inputs: sort, team, limit, owner, offset, archive, project, language, video_id, video_url
List Video URLs
Lists URLs associated with a video, with pagination for retrieving additional pages. Use to find video URLs for embedding or processing.
Inputs: limit, offset, video_id
Make Video URL Primary
Tool to set a video URL as the primary URL. Use when you need to designate one of a video's URLs as primary for embedding and display. Call after listing video URLs to confirm the URL ID.
Inputs: url_id, primary, video_id
Perform Subtitle Action
Tool to perform an action on subtitles such as publish, unpublish, approve, reject, send-back, or endorse. Use when you need to change the workflow state of subtitles for a specific video and language. The available actions depend on the current workflow state and team settings.
Inputs: action, video_id, language_code
Send Message
Sends a message to a user or team member in Amara. Use this tool to send notifications, updates, or communicate with other users or teams on the platform. You must specify either a recipient user (by username or user ID) or a team (by team slug), but not both.
Inputs: team, user, content, subject
Update Subtitle Language
Tool to update a subtitle language for a video. Use after reviewing existing subtitle language settings and needing to adjust completeness flags or soft-limit constraints.
Inputs: video_id, language_code, soft_limit_cpl, soft_limit_cps, soft_limit_lines, subtitles_complete, soft_limit_max_duration, soft_limit_min_duration, is_primary_audio_language
Update Video
Tool to update an existing video's metadata including title, description, team, and project assignment. Use when you need to modify video information after creation.
Inputs: team, title, project, duration, metadata, video_id, thumbnail, description, primary_audio_language_code
View Video Details
Tool to view details of a specific video by ID. Use when you need complete metadata for a given video.
Inputs: video_id