Deliver your customers' videos from your own site

Create a standard API key in your partner dashboard (Credentials → API keys). Send it as a bearer token from your server:

Authorization: Bearer mvm_live_xxxxxxxxxxxxxxxxxxxxxxxx

• Keys need the fulfilment:read scope to list and fulfilment:download to get links. Keys created from 14 October 2026 have both. Older standard keys do not: create a new one.
• Catalog keys are rejected with 403 wrong_key_type. A revoked key returns 401 revoked_api_key.
• You can only reach customers linked to your own partner account. Your partner is taken from the key, never from the request.
• Keep the key on your server. If it leaks, revoke it in the dashboard and create another.
• Rate limit: 100 requests per minute per key. Over it returns 429 rate_limited with Retry-After.

Customers are identified by the same partner_external_user_id you send in the signed embed payload. A customer exists here from the moment they first open your embed. Before that, calls return 404 user_not_found.

GET https://musicvideomarketplace.com/api/public/partner/v1/users/{external_user_id}/videos?limit=50&offset=0

URL-encode the user ID. limit is 1 to 100 (default 50); results are newest first.

{
  "external_user_id": "your-user-123",
  "total": 2,
  "limit": 50,
  "offset": 0,
  "videos": [
    {
      "video_id": "0b6f2c1e-6c1a-4a53-9a4f-3f0f0f0f0f0f",
      "title": "Sunset Vibes",
      "artist": "Example Artist",
      "thumbnail_url": "https://…",
      "duration_seconds": 240,
      "acquired_at": "2026-10-02T14:21:07Z",
      "source": "partner",
      "downloads": { "original": true, "reel": true, "bts": false },
      "exports": [
        {
          "export_id": "6d3a5b1c-2b7e-4c0a-8f55-9a1d3c7e2b10",
          "name": "My edit",
          "created_at": "2026-10-03T09:12:44Z",
          "files": ["main", "lyric"]
        }
      ]
    }
  ]
}

POST https://musicvideomarketplace.com/api/public/partner/v1/downloads
Content-Type: application/json

{
  "external_user_id": "your-user-123",
  "video_id": "0b6f2c1e-6c1a-4a53-9a4f-3f0f0f0f0f0f",
  "kind": "original"
}

{
  "download_url": "https://…",
  "filename": "Sunset_Vibes.mp4",
  "expires_in": 3600,
  "kind": "original"
}

• The link is valid for one hour and downloads the file with the right file name. Do not store links: ask for a new one each time a customer clicks Download, or redirect them to the link straight away.
• Ownership is checked on every request. Revoked licences stop working immediately.
• Reel files need a licence that covers the reel (partner purchases do) or the reel add-on. Behind-the-scenes needs that add-on. An export must belong to the same customer and video.
• Each link request is counted as a download in your usage statistics.

const BASE = 'https://musicvideomarketplace.com/api/public/partner/v1';
const headers = { Authorization: `Bearer ${process.env.MVM_API_KEY}`, 'Content-Type': 'application/json' };

// Your "My videos" page
async function myVideos(userId) {
  const res = await fetch(`${BASE}/users/${encodeURIComponent(userId)}/videos`, { headers });
  if (res.status === 404) return [];            // the customer has not used the embed yet
  if (!res.ok) throw new Error((await res.json()).error.message);
  return (await res.json()).videos;
}

// Your "Download" button handler: send the customer straight to a fresh link
async function downloadUrl(userId, videoId) {
  const res = await fetch(`${BASE}/downloads`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ external_user_id: userId, video_id: videoId, kind: 'original' }),
  });
  if (!res.ok) throw new Error((await res.json()).error.message);
  return (await res.json()).download_url;
}

Errors use one shape: { "error": { "code": "...", "message": "..." } }.

An API key labelled test works against your test customers only: the customers who signed in to the embed with your test client ID (see the partner embed guide, section 14). Pass the same partner_external_user_id you signed with. Responses include "test": true.

• The list shows the videos the test customer “bought” with the test card. downloads is always false for original, reel and behind-the-scenes: full-quality files are never available in test mode.
• Test exports (watermarked, 540p) can be listed and downloaded with kind: "export". Asking for an original returns 403 not_available_in_test.
• A live key never sees test customers, and a test key never sees live customers.