Generate download URLs
You are reading API v2 documentationStill using the Legacy API? Access the Legacy API documentation.
Download URLs allows Partners to programmatically retrieve video files directly from Dailymotion's CDN using the API.
This guide explains how to generate downloadable video file URLs for your content hosted on Dailymotion.
Prerequisites
Pro Enterprise plan with add-on Stream URL feature
Reach out to your Dailymotion Customer Success Manager or our Support team if you need to add the feature to your plan.
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 stream 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. Request download URLs
Call the download endpoint with the video ID. Replace the <VIDEO_ID> placeholder below with your own.
curl --request POST \
--url https://api.dailymotion.com/v2/videos/<VIDEO_ID>/downloads \
--header 'accept: application/json' \
--header 'authorization: Bearer ••••' \
--header 'content-type: application/json'Response
The endpoint returns all available muxed renditions for that video, each with its associated video_format_id, audio_format_ids, and a ready-to-use download_url. Simply use the download_url of the rendition you need. Each entry contains:
| Field | Type | Description |
|---|---|---|
type | Enum("muxed") | Nature of the downloadable file - Always "muxed". |
label | string | Human-readable quality label (ie. "HD (720p)") |
quality | string | Quality descriptor (ie. hd, sd) |
download_url | string | Time-limited, pre-signed download URL. Use this to fetch the file. |
video_format_id | string | Identifier of the video format included in this muxed file. |
audio_format_ids | Array[string] | Identifier(s) of the audio format(s) included in this muxed file. |
Example response:
{
"downloads": [
{
"type": "muxed",
"label": "SD (384p)",
"quality": "sd",
"download_url": "https://cdndirector.dailymotion.com/cdn/H264-512x384/video/VIDEO_ID.mp4?download=1&sec=123",
"video_format_id": "h264_aac",
"audio_format_ids": [
"aac_q1_0"
]
},
{
"type": "muxed",
"label": "HQ (480p)",
"quality": "hq",
"download_url": "https://cdndirector.dailymotion.com/cdn/H264-848x480/video/VIDEO_ID.mp4?download=1&sec=123",
"video_format_id": "h264_aac_hq",
"audio_format_ids": [
"aac_q2_0"
]
},
{
"type": "muxed",
"label": "HD (720p)",
"quality": "hd",
"download_url": "https://cdndirector.dailymotion.com/cdn/H264-1280x720-60/video/VIDEO_ID.mp4?download=1&sec=123",
"video_format_id": "h264_aac_hd_hfr",
"audio_format_ids": [
"aac_q2_0"
]
},
{
"type": "muxed",
"label": "FHD (1080p)",
"quality": "fhd",
"download_url": "https://cdndirector.dailymotion.com/cdn/H264-1920x1080-60/video/VIDEO_ID.mp4?download=1&sec=123",
"video_format_id": "h264_aac_fhd_hfr",
"audio_format_ids": [
"aac_q2_0"
]
}
]
}
download_urlare time-limitedUse them immediately to fetch the file. Do not store or cache them for later use.
Updated 1 day ago