Skip to main content

Just getting started with the Media API? See the following documents for details on using this API:

The API release history

The following table lists the releases for the Media API:


Release Date

Summary of Release



Added support for Documents.



Reduced video retention time to 30 days.



Added video moderation functionality.



Initial release of the Media API.


Users can create, upload, and fetch documents to attach to their listings. For example, product safety compliance documentation or user guides needed for the General Product Safety Regulations (GPSR).

New resource added

The document resource was added which includes the following new methods:

  • createDocument – This call is used to create a document resource. It creates a document ID based on the metadata sent.

  • getDocument – Retrieves the details and status of the specified document.

  • uploadDocument – This method uploads a document based on a document source and a provided document ID.


This release reduces the retention time for all new videos uploaded through the Media API from 365 days to 30 days.


This release of the Media API adds video moderation functionality.

After a video is uploaded using the uploadVideo method, it will undergo moderation. If the video is determined to be non-compliant (for one or more reasons) and is blocked by moderators, a new moderation container will be returned in the getVideo response. This container specifies the reason(s) why the video is blocked.

Tip: See the RejectReasonEnum type to view a complete list of reasons why a video may be blocked by moderators. Refer to Video moderation and restrictions for more information about video moderation.


This is the initial release of the Media API.

New methods:

  • createVideo – This call is used to create videos. It creates a video ID based on the metadata sent.
  • getVideo – This call is used to retrieve videos by means of the video's video ID.
  • uploadVideo – This method uploads a video based on a video source and a provided video ID.