Skip to main content

The energyEfficiencyLabel container is used to provide information about the energy efficiency for certain durable goods when creating a listing through the createOffer method, or when updating a listing through the updateOffer method.

Note: Use the getRegulatoryPolicies method of the MetadataAPI to return metadata on the eBay categories that recommend or require energy efficiency-related fields.

The following elements are required when providing energy efficiency information on a listing through the createOffer method:

  • imageDescription: A brief summary of the information included on the Energy Efficiency Label for the item.

  • imageURL: The URL to the Energy Efficiency Label image that is applicable to an item.

  • productInformationSheet: The URL to the Product Information Sheet that provides complete manufacturer-provided efficiency information about an item.

Note: Images can must provided in .JPEG, .PNG, .BMP, .GIF, or .TIF format and must be at least 500 pixels on the longest side.

In addition, when providing energy efficiency information on an appliance listing, the following item specifics must be specified through the aspects field when creating the inventory item record for the listing using the createOrReplaceInventoryItem method: 

  • range: The scale used for energy efficiency ratings. The energy efficiency range is typically measured using a letter scale (for example, A to G), where A is the most energy efficient, and G is the least energy efficient. The range can vary by product type.

  • rating: The energy efficiency grade of the item. For example, a rating of A indicates that the item meets the highest standards of energy efficiency on the A-G scale.

Note: Use the getItemAspectsForCategory method of the Taxonomy API to retrieve applicable rating and range values for a specified category.

When listing items in Tyre or Appliance categories, European Energy Efficiency (EEK) information can be retrieved through a third party vendor if this information is not provided by the seller. This process is detailed in the following sections.

Tyre categories

When uploading a listing in Tyre categories on EU marketplaces, the following information is required to be compliant with EEK regulations: 

  • Tyre label document

  • Product data sheet

Important! Sellers are required to upload both the Tyre label document and Product data sheet documents or neither. If the seller only uploads one document, an error will occur.

These documents can either be uploaded by the seller, or retrieved through a third party vendor. This process is described below: 

  • If a seller uploads both a Tyre label document and the Product data sheet through either a create or update call, these files will be displayed in the buyer experience. These seller-provided documents will take precedence over any documents retrieved by a third party vendor.

  • If a seller does not upload a Tyre label document and the Product data sheet, but a valid EAN has been provided through a create or update call, a call to a third party vendor will be made to retrieve this information to be displayed in the buyer experience.

Appliance categories

When uploading a listing in Appliance categories on EU marketplaces, the following information is required to be compliant with EEK regulations: 

  • Appliance label document

  • Product data sheet

  • The energy efficiency range of the product

  • The energy efficiency rating of the product

Important! Sellers are required to upload both the Appliance label document and Product data sheet documents or neither. If the seller only uploads one document, an error will occur.

These documents can either be uploaded by the seller, or retrieved through a third party vendor. This process is described below: 

  • If a seller uploads both a Appliance label document and the Product data sheet through either a create or update call, these files will be displayed in the buyer experience. These seller-provided documents will take precedence over any documents retrieve by a third party vendor.

  • If a seller does not upload Appliance label document and the Product data sheet, but the Brand, MPN, and EAN of the item have been provided through a create or update call, a call to a third party vendor will be made to retrieve this information to be displayed in the buyer experience.