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.