Get Video Brands
Branding - Video
Get Video Brands
Retrieve all video brand configurations defined in the Pictory application
GET
Get Video Brands
Documentation Index
Fetch the complete documentation index at: https://docs.pictory.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Fetch all video brand configurations defined in the Pictory App. Video brands are customizable presets that define your video’s visual identity, including color schemes, fonts, logos, animations, and other branding elements. These brands ensure consistent styling across all your video projects. Use this endpoint to retrieve available brand configurations for video editing, maintaining brand consistency, or allowing users to select from predefined branding options for their video projects.You need a valid API key to use this endpoint. Get your API key from the API Access page in your Pictory dashboard.
API Endpoint
Request Parameters
Headers
API key for authentication (starts with
pictai_)Response
Returns an array of video brand objects, each containing a unique identifier and descriptive name.List of available video brands
Response Examples
Code Examples
Common Use Cases
1. List All Available Video Brands
Retrieve and display all video brands:2. Create Brand Selector for UI
Build a dropdown/selector component:3. Search Brands by Name
Find brands matching specific criteria:4. Cache Brands Locally
Cache brands to reduce API calls:5. Validate Brand ID Before Use
Check if a brand ID exists:Brand Configuration
Video brands typically include the following elements:| Element | Description | Purpose |
|---|---|---|
| Color Palette | Primary, secondary, and accent colors | Consistent color scheme across videos |
| Typography | Font families, sizes, and weights | Text styling and readability |
| Logo | Company or personal logo | Brand identity and recognition |
| Intro/Outro | Opening and closing sequences | Professional video bookends |
| Lower Thirds | Text overlays for names and titles | Professional presentation |
| Transitions | Animation styles between scenes | Smooth visual flow |
| Music Theme | Default background music style | Audio branding |
| Watermark | Brand watermark positioning | Content ownership |
Usage Notes
Brand IDs: Use the UUID
id field when applying brands to video projects. Brand names are for display purposes only.Consistent Branding: The same video brands are available across all your video projects, ensuring brand consistency.
Best Practices
- Cache Brands: Fetch brands once and cache them locally. Video brands change infrequently.
-
Use Brand IDs: Always reference brands by their UUID
id, not by name. Names may change, but IDs remain constant. - Default Brand: Most accounts have a “Default Brand” that can be used as a fallback option.
- Validate Brand IDs: Before applying a brand to a project, verify the ID exists in the current list of available brands.
- Sort Alphabetically: Present brands in alphabetical order for easy browsing in user interfaces.
- Handle Missing Brands Gracefully: If a referenced brand ID does not exist, fall back to the default brand.
- Brand Previews: If possible, display visual previews of brand styles to help users make selections.
- User Permissions: Ensure users have appropriate permissions to access and use specific brands.
Integration with Projects
Apply a video brand to a project during creation or updates:Related Endpoints
- Get Text Styles - Retrieve text styling options
- Get Projects - List all video projects
- Update Project - Modify project settings including brand
