Media API Release Notes



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

• Buying Integration Guide
• Selling Integration Guide
• Using eBay RESTful APIs
• Media API Overview
• Media API Reference

The API release history

The following table lists the releases for the Media API:

Version	Release Date	Summary of Release
v1_beta.4.1	2025年07月01日	Added new enum to DocumentTypeEnum.
v1_beta.4.0	2025年04月17日	Added support for images.
v1_beta.3.1	2025年04月10日	Added a new languageEnum value: PORTUGUESE.
v1_beta.3.0	2025年02月03日	Added the createDocumentFromUrl method to the document resource.
v1_beta.2.0	2024年07月16日	Added support for Documents.
v1_beta.1.1	2024年04月08日	Reduced video retention time to 30 days.
v1_beta.1.0	2021年10月06日	Added video moderation functionality.
v1_beta.0.0	2021年04月29日	Initial release of the Media API.

v1_beta.4.1

This release adds "ACCESSIBILITY_INFORMATION" as a new document type, detailing features that enhance product usability for individuals with disabilities, reinforcing our commitment to inclusivity.

v1_beta.4.0

Users can upload a picture file to eBay Picture Services (EPS), which returns a URL that can be used to add pictures to their listings.

New resource added

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

• createImageFromFile – This method uploads a picture file to eBay Picture Services (EPS) using multipart/form-data.

• createImageFromUrl – This method uploads a picture to eBay Picture Services (EPS) from the specified URL.

• getImage – This method is used to retrieve image details using the image_id. This call retrieves the URL that can be used to access the uploaded image, and the image's expiration date.

V1_beta.3.1

This release adds the PORTUGUESE enum value the languageEnum enumerated type. This value was added to replace a mispelled value currently in the enumerated type. This new value should be used going forward, and the old value (PORTUGESE) will be decommissioned at a later day. The official date for this decommission will be listed on the API Deprecation Status page once it has been determined.

V1_beta.3.0

This release adds the createDocumentFromUrl method to the document resource. This method is used to download a document from the provided URL and add it to the user's account.

v1_beta.2.0

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.

v1_beta.1.1

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

v1_beta.1.0

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.

v1_beta.0.0

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.