Videos

Import a video from a public HTTPS MP4 URL

Downloads a single public HTTPS MP4, stages it for ingestion, and starts the background video pipeline. Returns 202 while processing, or 200 with videoId immediately when the organization already has the same video (content duplicate).

Requires the videos:write scope. Subject to a stricter per-key rate limit than generic public API routes (default 5 imports per hour per API key).

Poll GET /v1/videos/import/{sessionId} until status is ready or failed. Use the returned videoId in Full Control campaign creativeDirection.selectedCreatives.

POST

videos

import

Import a video from a public HTTPS MP4 URL

curl --request POST \
  --url https://api.getsoundlink.com/v1/videos/import \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "https://cdn.example.com/promo.mp4"
}
'

import requests

url = "https://api.getsoundlink.com/v1/videos/import"

payload = { "url": "https://cdn.example.com/promo.mp4" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'https://cdn.example.com/promo.mp4'})
};

fetch('https://api.getsoundlink.com/v1/videos/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "videoId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "meta": {
    "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

Authorizations

x-api-key

string

header

required

Pass your Soundlink sk_* API key in the x-api-key header. Keys can carry explicit scopes (for example campaigns:read, metrics:read, videos:write) enforced by the backend.

Deprecated, retiring 2026-08-17 — migrate to Authorization: Bearer sk_... (see apiKeyBearerAuth) before then.

Body

application/json

url

string<uri>

required

Public HTTPS URL to an MP4 file (max 50 MB).

Response

Duplicate video already in the organization's library

data

object

required

Show child attributes

meta

object

required

Show child attributes

Import a video from a public HTTPS MP4 URL

curl --request POST \
  --url https://api.getsoundlink.com/v1/videos/import \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "url": "https://cdn.example.com/promo.mp4"
}
'

import requests

url = "https://api.getsoundlink.com/v1/videos/import"

payload = { "url": "https://cdn.example.com/promo.mp4" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({url: 'https://cdn.example.com/promo.mp4'})
};

fetch('https://api.getsoundlink.com/v1/videos/import', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "videoId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "meta": {
    "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

System

Campaigns

Metrics

Videos

Import a video from a public HTTPS MP4 URL

Authorizations

Body

Response