The Clipping Video API enables seamless management of video clipping profiles, integrations, metadata, and YouTube authentication. With this API, you can create, update, and manage your clipping workflows efficiently, ensuring smooth integration with third-party platforms like YouTube, Facebook, and Twitter.

Key Features

Profiles Management: Create and manage clipping profiles that define how clips are configured and stored.
Integrations: Connect clipping profiles with third-party platforms for automated sharing.
Metadata Handling: Attach and modify metadata to enhance clip organization and discoverability.
YouTube Authentication: Securely authenticate YouTube accounts for direct publishing.

Clipping Profiles

Clipping profiles define how video clips are created and managed. Each profile includes settings and configurations that determine the behavior of the clipping process.

Available Endpoints

Endpoint	Description
GET /clipping-profiles	Retrieve a list of clipping profiles.
GET /clipping-profiles/{Clipping Profile ID}	Retrieve details of a specific clipping profile.
POST /clipping-profiles	Add a new clipping profile with specified configurations.
PATCH /clipping-profiles/{Clipping Profile ID}	Update an existing clipping profile.
DELETE /clipping-profiles/{Clipping Profile ID}	Remove a specified clipping profile.

Integrations

Integrations allow you to link your clipping profiles with third-party platforms like YouTube, Facebook, Kaltura, Lakana, and Twitter, making it easy to share and manage video clips across multiple destinations.

Available Endpoints

Endpoint	Description
GET /clipping-profiles/{Clipping Profile ID}/integrations	Retrieve a list of integrations associated with a specific clipping profile.
GET /clipping-profiles/{Clipping Profile ID}/integrations/{Integration ID}	Retrieve details of a specific integration.
POST /clipping-profiles/{Clipping Profile ID}/integrations	Add a new integration for a clipping profile.
PATCH /clipping-profiles/{Clipping Profile ID}/integrations/{Integration ID}	Update the configuration of an existing integration.
DELETE /clipping-profiles/{Clipping Profile ID}/integrations/{Integration ID}	Remove a specified integration from a clipping profile.

Metadata

Metadata enhances the organization and discoverability of video clips by attaching key-value pairs that provide additional context.

Available Endpoints

Endpoint	Description
GET /clipping-profiles/{Clipping Profile ID}/metadata	Retrieve a list of metadata entries for a specific clipping profile.
GET /clipping-profiles/{Clipping Profile ID}/metadata/{Metadata ID}	Retrieve details of a specific metadata entry.
POST /clipping-profiles/{Clipping Profile ID}/metadata	Add new metadata to a clipping profile.
PATCH /clipping-profiles/{Clipping Profile ID}/metadata/{Metadata ID}	Update an existing metadata entry.
DELETE /clipping-profiles/{Clipping Profile ID}/metadata/{Metadata ID}	Remove a specific metadata entry from a clipping profile.

YouTube Authentication

To enable seamless publishing of clips to YouTube, the API provides a dedicated authentication mechanism that allows users to authenticate their YouTube accounts securely.

Request Syntax

GET /clipping-profiles/youtube/login?profile_id={Clipping Profile ID}

Required Variable

Variable	Description
Clipping Profile ID	Identifies a clipping profile by its system-defined or external ID. Use the "Get Multiple Clipping Profiles" endpoint to retrieve valid IDs.

Response

A successful request returns a 200 OK response containing:

Name	Data Type	Description
URL	String	URL to obtain YouTube authentication from the customer.

Authentication

The Clipping Video API requires authentication using our Authentication to ensure secure access to endpoints.

For further details on API usage, refer to the full API documentation.