Authentication

Every v1 operation requires the 16-character API key associated with an active Videobase account.

Header authentication

Send the key in the X-Api-Key header. This is the recommended method.

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

The backend also accepts the key in a key query parameter:

curl --request GET \
  --url "https://api.videobase.com/v1/account?key=YOUR_API_KEY"

Prefer header authentication. Query strings can appear in browser history, reverse-proxy logs, analytics tools, and copied URLs.

A missing, malformed, revoked, or unknown key returns HTTP 500 with an error body:

{
  "message": "Invalid API Key",
  "status": 500
}

See Error handling for the complete error contract.

⌘I