The auto-embed API

Introduction

The CloudNEXTRA API lets you embed players, pull rich metadata and serve your own uploads from anywhere. Responses are JSON; embeds are plain <iframe> URLs — no SDK required. The auto-embed engine resolves the best available source, caches it, and keeps it fresh automatically.

Authentication

Authenticate every request with your API key in the Authorization header. Create and rotate keys from your dashboard.

Authorization: Bearer cnx_live_8fK2pQ7sR1vT4wX9

Keep keys secret. Never expose a cnx_live_ key in client-side code — use cnx_embed_ public keys for browser embeds.

Base URL

All endpoints are relative to this base. The edge CDN routes you to the nearest of 60+ locations automatically.

Embed a title

Return a ready-to-play player URL for any catalog ID or your own upload ID. Drop it straight into an iframe.

curl https://api.cloudnextra.one/v2/embed/8fK2pQ \
  -H "Authorization: Bearer cnx_live_8fK2pQ7sR1vT4wX9"

const res = await fetch("https://api.cloudnextra.one/v2/embed/8fK2pQ", {
  headers: { Authorization: "Bearer cnx_live_8fK2pQ7sR1vT4wX9" }
});
const { embed_url } = await res.json();

<iframe src="https://cdn.cloudnextra.one/embed/8fK2pQ"
  allow="autoplay; fullscreen" allowfullscreen></iframe>

Response

{
  "id": "8fK2pQ",
  "embed_url": "https://cdn.cloudnextra.one/embed/8fK2pQ",
  "status": "ready",
  "qualities": [360, 720, 1080],
  "subtitles": ["en", "es", "fr"],
  "resume": true
}

Get metadata

Fetch title, duration, poster, available qualities and view stats for any ID.

{
  "id": "8fK2pQ",
  "title": "Summer Trip — Final Cut",
  "duration": 742,
  "poster": "https://cdn.cloudnextra.one/thumb/8fK2pQ.jpg",
  "size_mb": 248,
  "views": 48213,
  "streamable": true
}

Search catalog

Query by keyword and paginate. Great for building an auto-updating grid of titles.

curl "https://api.cloudnextra.one/v2/search?q=nebula&page=1" \
  -H "Authorization: Bearer cnx_live_..."

Your uploads

List your own files, check conversion status and pull per-video earnings.

Errors

Standard HTTP codes. Error bodies include a machine-readable code and human message.

Rate limits