Skip to main content

Getting Started

Welcome to the SixtySeconds API. Our platform enables you to programmatically create, edit, and manage bespoke videos with AI messaging to power your entire customer journey.

Key Features​

AI-Powered Personalization

Create personalized video content at scale with our advanced AI messaging system.

Bespoke Video Templates

Choose from our extensive library of professionally designed video templates or create custom ones.

Comprehensive Analytics

Track video performance with detailed engagement metrics and conversion data.

Base URL​

All API requests should be made to the following base URL:

https://api.sixtyseconds.video/v1
API Status

The SixtySeconds API is production-ready for enterprise customers. See our changelog for regular updates and new features.

Authentication​

The SixtySeconds API uses API keys for authentication. You can obtain your API key from your developer dashboard after creating an account.

API Key Authentication​

Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY
Security Notice

Never expose your API key in client-side code or public repositories. For frontend applications, use a backend proxy to make API requests.

Videos​

The Videos API allows you to create, manage, and process personalized videos for your customers.

Retrieve videos list​

GET/videos

Retrieves a list of videos in your account.

Query Parameters​

ParameterTypeDescription
pageintegerOptional Page number for pagination (default: 1)
limitintegerOptional Number of items per page (default: 20, max: 100)
statusstringOptional Filter by video status (draft, processing, published, failed)

Response​

{
  "data": [
    {
      "id": "vid_12345abcde",
      "title": "Welcome Message for John",
      "status": "published",
      "duration": 58.5,
      "created_at": "2025-02-15T10:30:00Z",
      "url": "https://cdn.sixtyseconds.video/videos/vid_12345abcde.mp4",
      "thumbnail": "https://cdn.sixtyseconds.video/thumbnails/vid_12345abcde.jpg"
    },
    {
      "id": "vid_67890fghij",
      "title": "Product Demo for Enterprise",
      "status": "processing",
      "duration": null,
      "created_at": "2025-02-16T14:25:00Z",
      "url": null,
      "thumbnail": null
    }
  ],
  "pagination": {
    "total": 42,
    "page": 1,
    "limit": 20,
    "next_page": 2,
    "prev_page": null
  }
}

Create a new video​

POST/videos

Creates a new personalized video using a template and customer data.

Request Body​

ParameterTypeDescription
titlestringRequired The title of the video
template_idstringRequired ID of the template to use
customer_dataobjectRequired Customer data for personalization
ai_messagingobjectOptional AI messaging parameters for personalization
aspect_ratiostringOptional Video aspect ratio (9:16, 16:9, 1:1) (default: 9:16)
project_idstringOptional Project to assign this video to

Example Request​

{
  "title": "Welcome Message for Sarah",
  "template_id": "tmpl_welcome_message",
  "customer_data": {
    "first_name": "Sarah",
    "last_name": "Johnson",
    "company": "Acme Inc",
    "product_interest": "Enterprise Plan"
  },
  "ai_messaging": {
    "tone": "friendly",
    "key_points": ["product benefits", "next steps"]
  },
  "aspect_ratio": "16:9",
  "project_id": "proj_customer_onboarding"
}

Quick Guides​

Check out our guides to learn more about using our API:

Useful Resources​