Developer Documentation

Authentication – ClipKraft API

Authentic Stock Video for Professionals. Secure your integrations with robust API key management and OAuth 2.0 authorization for seamless, user-scoped video downloads.

Server-Side Integration

API Keys Management

Generate and rotate long-lived credentials for backend services that query the ClipKraft catalog or process batch licensing requests.

Create Your First Key

Navigate to Settings > API Access in your developer dashboard. Click "Generate Production Key" and assign the catalog:read and license:write scopes. Your key will follow the ck_prod_8x9a2b format and is valid for 365 days before automatic rotation.

Security & Rate Limits

Never expose production keys in client-side code or public repositories. ClipKraft enforces a strict 1,200 requests per minute limit per key. Implement exponential backoff for 429 Too Many Requests responses and store credentials in environment variables like CLIPKRAFT_API_SECRET.

Generate New Key View Reference
Client-Side Authorization

OAuth 2.0 Flow

Implement secure, user-delegated access for applications that download clips on behalf of end customers without handling their ClipKraft passwords.

Authorization Code Grant

Direct users to https://auth.clipkraft.com/authorize with your client_id, redirect_uri, and download:read+user:profile scopes. After consent, ClipKraft returns a temporary authorization code valid for 5 minutes.

Token Exchange & Refresh

POST the code to /oauth/token along with your client secret to receive an access token (expires in 3,600 seconds) and a refresh token. Use the refresh token to silently renew sessions without interrupting the user's video editing workflow.

Register OAuth Client Step-by-Step Guide