Create a video

post

https://partner.api.dailymotion.com/rest/user/{PROFILE_ID}/videos

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

PROFILE_ID

string

required

The unique identifier of your Dailymotion profile

Query Params

fields

string

List of fields to return.

To add several fields, separate each value with a comma (i.e. title,description)

Sample of possible values: title description id channel content_provider_id country created_time duration embed_html embed_url geoblocking is_created_for_kids language mode private private_id publish_date published url

See the exhaustive list of possible values and their description.

Form Data

channel

string

Defaults to news

Category of the video.

Possible values: animals auto creation fun kids lifestyle music news people school shortfilms sport tech travel tv videogames webcam

See all video categories.

title

string

Defaults to My new video

Title of the video.

is_created_for_kids

boolean

Defaults to false

True if this video is "created for kids" (intends to target an audience under the age of 16).

description

string

Comprehensive description of this video. Maximum length is set to 3000.

geoblocking

array of strings

Defaults to allow

List of countries where this video is or isn't accessible. To set geoblocking on your videos, you have to be a Dailymotion Pro.

A list of country codes (ISO 3166-1 alpha-2) starting with the `deny` or `allow` (default) keyword to define if this is a block or an allowlist.

E.g.: both `allow, fr, us, it` and `fr, us, it` will allow this video to be accessed in France, US and Italy and deny all other countries.
On the other hand, `deny, us, fr` will deny access to this video in the US and France and allow it everywhere else.
An empty list or simply `allow` (the default) will revert the behavior to allow from everywhere.

geoblocking

url

string

required

Defaults to https://www.source-to-your-file.mp4

The URL of the video to use as the source. This defines where Dailymotion should fetch the video source from. You can provide this URL during video creation, or update it later to change the video source.

You can either:
- Use the GET /file/upload endpoint to generate a temporary upload URL, or
- Provide a direct link to a video file you host.

Note: Writing to this parameter is subject to rate limiting.

allow_embed

boolean

True if this video can be embedded outside of Dailymotion.

allowed_in_playlists

boolean

True if this video can be added to playlists

country

string

Limit the result set to this country (declarative).
Example: us

end_time

string

End date and time of this live stream.
Sample value: 1404129540

expiry_date

string

Date and time after which this video will be made private.

Beware: if the video was originally defined as private, setting this value will automatically make it public between its publish_date and expiry_date. This setting only affects the visibility of the video, it will still be available to anyone who knows how to access the video’s private URL even after this date. Omitting this value while setting a past publish_date never expires the video. Set to null (recommended) or a date after Jan 19th 2038 to reset this parameter.

Note : Only Pro Advanced & Enterprise customers are allowed to manage video availability and expiration dates.

Sample value: 1287507036

expiry_date_availability

boolean

By default, videos reaching their expiry_date are still available to anyone who knows how to access their private URL. Set this to false to disable this behavior.

expiry_date_deletion

boolean

By default, videos are deleted (after a grace period) when their expiry_date is reached. Set this to false to disable this behavior.

Note: Only Pro Advanced & Enterprise customers are allowed to manage video availability and expiration dates.

explicit

string

True if this video is explicit.
Warning: It’s not possible to remove this flag once set.

geoloc

array of strings

Geolocalization for this video. Result is an array with the longitude and latitude using point notation. Longitude range is from -180.0 (West) to 180.0 (East). Latitude range is from -90.0 (South) to 90.0 (North).

Sample value: -122.40061283112, 37.782112059896
Min: 1 Max: 150

geoloc

hashtags

array of strings

List of hashtags attached to this video.

Sample value: # hello, #world
Min: 1 Max: 150

hashtags

language

string

Language of this video. This value is declarative and corresponds to the user-declared spoken language of the video. Allowed values are ISO-639-3 alpha-2 and alpha-3 language codes.

Sample value: en
Min: 1 Max: 150

live_ad_break_launch

integer

Launches a given number of ad breaks for this live stream.

Sample value: 1

live_auto_record

boolean

True if this live stream is automatically recorded.

mode

string

Stream mode. Allowed values: vod or live

private

boolean

True if this video is private.

publish_date

string

Date and time after which this video will be made publicly available.

Beware: If the video was originally defined as private, setting this value will automatically make it public after the publish_date.

This setting only affects the visibility of the video, it will still be available to anyone who knows how to access the video’s private URL even before this date. Omitting this value while setting a future expiry_date immediately publishes the video. Set to null (recommended) or a date before Jan 1st 1990 to reset this parameter.

Note: Only verified partners are allowed to manage video availability and expiration dates.

Sample value: 1287507036

publish_date_keep_private

boolean

Keep this video private when its publication_date is reached.

published

boolean

True if this video is published (may still be waiting for encoding, see the status field for more information).

record_status

string

Current state of the recording process of this video. * starting: Recording video is going to start. * started: Recording video is in progress. * stopping: Recording video is going to stop. * stopped: Recording video is stoppedSample value: started.

soundtrack_isrc

string

The International Standard Recording Code of the soundtrack associated to this video.

Sample value: FR-6V8-21-83311
Min: 1 Max: 150

soundtrack_popularity

integer

Soundtrack popularity.

Sample value: 100
Min: 0

start_time

string

Start date and time of this live stream.

Sample value: 1287507036

stream_altered_with_ai

boolean

Whether the video stream has been altered by AI.