Skip to main content

  • Important Update: eBay's API integrations will be modified to address data handling requirements for select developers. Usernames will be replaced with immutable user IDs, and financial data will be protected for certain users. Learn more here.
  • API License Agreement Update: We have made significant enhancements to our API License Agreement, including detailed data protection measures and compliance with international regulations. Important restrictions have been applied to the use of Restricted APIs and AI content. Developers must review the updated agreement to ensure compliance.

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

  • images
  • videos
  • documents (for GPSR regulations)

image

Method NameHTTP MethodPathSummarySamples
createImageFromFilePOST/image/create_image_from_fileCreates an eBay Picture Services (EPS) image by uploading a file using multipart/form-data.View createImageFromFile - /image/create_image_from_file
createImageFromUrlPOST/image/create_image_from_urlCreates an eBay Picture Services (EPS) image from the specified URL.View createImageFromUrl - /image/create_image_from_url
getImageGET/image/{image_id}Retrieves the details of a specified image.View getImage - /image/{image_id}

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
createDocumentFromUrlPOST/document/create_document_from_urlDownloads a document from the provided URL and adds the document to the user's account.View createDocumentFromUrl - /document/create_document_from_url
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