Skip to main content

  • Important: Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signature to be included in the HTTP payload.

  • OpenAPI Specification - Version 2.0 for all of our RESTful APIs will no longer be available starting April 5, 2023. We will continue leveraging OpenAPI Specification - Version 3.0 for new features in our RESTful APIs.

The Media API lets sellers to create, upload, and retrieve files, including:

  • videos
  • documents (for GPSR regulations)

video

Method NameHTTP MethodPathSummarySamples
createVideoPOST/videoProvides metadata for a video that will be uploaded via uploadVideo.View createVideo - /video
getVideoGET/video/{video_id}Retrieves the details for a specified video.View getVideo - /video/{video_id}
uploadVideoPOST/video/{video_id}/uploadUploads a video based on a provided video input source file and video ID.View uploadVideo - /video/{video_id}/upload

document

Method NameHTTP MethodPathSummarySamples
createDocumentPOST/documentCreates a document ID with metadata that is used to upload a document file.View createDocument - /document
getDocumentGET/document/{document_id}Retrieves the details and status of the specified document.View getDocument - /document/{document_id}
uploadDocumentPOST/document/{document_id}/uploadUploads the document file associated with the specified document ID.View uploadDocument - /document/{document_id}/upload