Reference
Release NoteHelpcenterStatus PageContact Us
  1. Client Side Endpoints
  2. Video

Create a video

post
https://api.dailymotion.com/user//videos
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚀

API v2 now available

Visit the API v2 documentation or follow the migration guide to upgrade.



👍

Authentication required

Required scope: manage_videos

⚠️

Note

This endpoint allows you to create a video object on your profile, but it does not upload the file itself. Point to the video source using the url parameter with either:

  • A direct video file URL hosted on your side, or
  • A temporary upload URL hosted on our side, obtained via the "Upload a video file" endpoint.

Path Params
string
required

The unique identifier of your Dailymotion profile

Query Params
string

List of fields to return. See fields description.

Form Data
string
required
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.

string
required
Defaults to My new video

Title of the video.

boolean
required
Defaults to false

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

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
string
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.

boolean

True if this video can be embedded outside of Dailymotion.

boolean

True if this video can be added to playlists

string

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

date-time

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

date-time

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

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.

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.

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
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

integer

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

Sample value: 1

boolean

True if this live stream is automatically recorded.

string

Stream mode. Allowed values: vod or live

boolean

True if this video is private.

date-time

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

boolean

Keep this video private when its publication_date is reached.

boolean

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

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.

string

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

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

integer

Soundtrack popularity.

Sample value: 100
Min: 0

date-time

Start date and time of this live stream.

Sample value: 1287507036

boolean

Whether the video stream has been altered by AI.

tags
array of strings

List of tags attached to this video.

Sample value: party john doe
Min: 1 Max: 150

tags
string

URL of this video’s raw thumbnail (full size respecting ratio). Some users have the permission to change this value by providing an URL to a custom thumbnail. If you don’t have the permission, the thumbnail won’t be updated. Note: for live streams, the thumbnail is automatically generated every 5 mn by default; it is not possible anymore to manually refresh the preview. Maximum allowed file size is 10MB.

Sample value: https://s2.dmcdn.net/CTrg1.jpg

Response
200

Updated about 1 hour ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated about 1 hour ago

Did this page help you?