Quickstart

Use your API key to retrieve your Videobase account details.

Prerequisites

You need:

A Videobase account
The 16-character API key generated from your account page

Keep your API key on your server. Do not expose it in browser code, public repositories, logs, or shared screenshots.

Make a request

Replace YOUR_API_KEY with your key.

curl --request GET \
  --url https://api.videobase.com/v1/account \
  --header "Accept: application/json" \
  --header "X-Api-Key: YOUR_API_KEY"

const response = await fetch("https://api.videobase.com/v1/account", {
  headers: {
    Accept: "application/json",
    "X-Api-Key": process.env.VIDEOBASE_API_KEY,
  },
});

const data = await response.json();

if (!response.ok) {
  throw new Error(data.message ?? `Videobase request failed (${response.status})`);
}

console.log(data);

import os
import requests

response = requests.get(
    "https://api.videobase.com/v1/account",
    headers={
        "Accept": "application/json",
        "X-Api-Key": os.environ["VIDEOBASE_API_KEY"],
    },
    timeout=30,
)
data = response.json()

if not response.ok:
    raise RuntimeError(data.get("message", f"Videobase request failed ({response.status_code})"))

print(data)

A successful request returns account data:

{
  "email": "[email protected]",
  "balance": "12.45000",
  "premiumExpire": "2026-12-31 23:59:59",
  "isPremium": true,
  "storage": {
    "total": "Unlimited",
    "used": 1048576,
    "left": "Unlimited"
  }
}

Storage values are in KB. Premium accounts return "Unlimited" for storage.total and storage.left.

Next steps

Browse the API reference

Explore account, upload, folder, video, and subtitle operations.

Handle errors

Learn the current HTTP status and error body contract.

⌘I

Getting started

API guides

Prerequisites

Make a request

Next steps

Browse the API reference

Handle errors

​Prerequisites

​Make a request

​Next steps

Browse the API reference

Handle errors

Prerequisites

Make a request

Next steps