Generate stream URLs

To keep your content safely hosted at Dailymotion and integrate it with third-party players, you can generate stream URLs.

In API v2, streaming URLs are generated via a dedicated action endpoint: POST /v2/videos/{id}/streams. This endpoint generates time-limited URLs on every call.

Use this endpoint any time a user or player is about to start playback. Do not pre-generate and store these URLs.

Prerequisites

Private API key with Generate stream URLs permission

In Dailymotion Studio > Organization settings > API keys > Create API key > Private API key > Toggle on "Generate stream URLs".

1. Authenticate

To generate download URLs via the API v2, you need an access token with the video.read scope. Refer to the authentication guide.

curl --request POST \
     --url https://oauth2.dailymotion.com/v2/token \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data grant_type=client_credentials \
     --data scope=video.read \
     --data client_id=<CLIENT_ID> \
     --data client_secret=<CLIENT_SECRET>

2. Generate a stream URL

Call the streams endpoint with your video ID. You can optionally specify a protocol to get only one stream format. If you omit protocol, the server returns entries for all available protocols (HLS, DASH, and HbbTV depending on what was encoded).

By default, generated URLs are IP-locked (restricted to the caller's IP/AS) and time-limited. You can relax these restrictions using optional body fields — see Restriction options below.

Get all available stream URLs:

curl -X POST "https://api.dailymotion.com/v2/videos/<VIDEO_ID>/streams" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \

Get only the HLS stream URL:

curl -X POST "https://api.dailymotion.com/v2/videos/<VIDEO_ID>/streams" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"protocol": "hls"}'

Get only the DASH stream URL:

curl -X POST "https://api.dailymotion.com/v2/videos/<VIDEO_ID>/streams" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"protocol": "dash"}'

3. Restriction options (optional)

By default, stream URLs are locked to the caller's IP/AS and are time-limited. If you are relaying traffic on behalf of an end-user (e.g. server-to-server calls), you can relax these restrictions using the following optional body fields:

Lock the URL to a specific end-user IP:

curl -X POST "https://api.dailymotion.com/v2/videos/<VIDEO_ID>/streams" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"client_ip": "203.0.113.7"}'

Generate an unrestricted URL (no IP lock, no expiration):

curl -X POST "https://api.dailymotion.com/v2/videos/<VIDEO_ID>/streams" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"no_ip_lock": true, "no_expire": true}'

Response

The response is a list of stream URL objects. Each entry contains:

Example response:

{
  "stream_urls": [
    {
      "protocol": "hls",
      "stream_url": "https://cdn.example.com/playlist.m3u8?token=abc"
    }
  ]
}