← Back to toolkits
Amara logo

Amara

Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.

transcriptionvideo & audio

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