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

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

The API release history

The following table lists the Feed API releases. For older releases, see the Feed API Release Notes Archive.

Release Version Release Date Description of Release
v1_beta.34.1 2023-04-26 Removed support for the Switzerland (EBAY_CH) marketplace.
v1_beta.34.0 2023-02-07 Added support for the following new fields in the getItemFeed and getItemSnapshot methods: hazmatSignalWordId, hazmatSignalWord, hazmatStatementIds, hazmatStatementDescriptions, hazmatPictogramIds, hazmatPictogramDescriptions, hazmatPictogramImageUrls, hazmatAdditionalInformation, and repairScore.
v1_beta.33.0 2022-05-04 Added support for coupons in the getItemSnapshotFeed method
v1_beta.32.0 2022-03-14 Added support for the following new fields in the getItemFeed method: ecoParticipationFeeValue, ecoParticipationFeeCurrency, takeBackPolicyLabel, and takeBackPolicyDescription
v1_beta.31.0 2022-02-15 Added support for the following new fields in the getItemSnapshotFeed method: authenticityGuaranteeServiceId, authenticityGuaranteeSelection, authenticityGuaranteeFeeValue, and authenticityGuaranteeFeeCurrency
v1_beta.30.0 2021-12-15 Added the following new fields to the getItemSnapshotFeed method: ecoParticipationFeeCurrency, ecoParticipationFeeValue, takeBackPolicyDescription, takeBackPolicyLabel
v1_beta.29.1 2021-11-09 Added support for the following marketplaces in the getItemFeed, getItemGroupFeed, and getItemSnapshotFeed methods:
  • Austria (EBAY_AT)
  • Switzerland (EBAY_CH)
v1_beta.29.0 2021-08-31 Added the following new fields to the getItemFeed method: ItemCreationDate, ItemWebUrl, DefaultImageUrl, ItemAffiliateWebUrl, AgeGroup, Color, Pattern, Size, Gender, Material, TotalUnits
v1_beta.28.0 2021-08-03

Added a new getItemPriorityFeed method. You can now get a daily Priority Item feed file using the getItemPriorityFeed method. This file contains all the items whose statuses have changed in a specified campaign. You can use this file to update the information of your curated stored items

Added a new priorityListingPayload response field to the getItemFeed method

v1_beta.27.0 2021-07-19 Added the following new fields to the getItemSnapshot method: description, defaultImageUrl, changeMetadata, itemWebUrl, itemAffiliateWebUrl, color, size, gender, ageGroup, material, pattern, totalUnits.

v1_beta.34.1

EBAY_CH (Switzerland) is no longer supported by the Feed Beta API.

v1_beta.34.0

The getItemFeed and getItemSnapshot methods now return the following additional fields for items listed in the feed:

  • hazmatSignalWordId
  • hazmatSignalWord
  • hazmatStatementIds
  • hazmatStatementDescriptions
  • hazmatPictogramIds
  • hazmatPictogramDescriptions
  • hazmatPictogramImageUrls
  • hazmatAdditionalInformation
  • repairScore

v1_beta.33.0

The getItemSnapshotFeed method now returns the following additional fields for items listed in the feed:

  • couponDiscountType
  • couponRedemptionCode
  • couponMessage
  • couponTermsWebUrl
  • couponDiscountValue
  • couponDiscountCurrency
  • couponExpirationDate

These new fields are currently only supported for the following eBay marketplaces:

  • EBAY_AU
  • EBAY_DE
  • EBAY_UK
  • EBAY_US

v1_beta.32.0

The getItemFeed method now returns the following additional fields for items listed in the feed:

  • ecoParticipationFeeValue
  • ecoParticipationFeeCurrency
  • takeBackPolicyLabel
  • takeBackPolicyDescription

v1_beta.31.0

The getItemSnapshotFeed method now returns the following additional fields for items listed in the feed:

  • authenticityGuaranteeFeeCurrency
  • authenticityGuaranteeFeeValue
  • authenticityGuaranteeSelection
  • authenticityGuaranteeServiceId

These fields provide information on Authenticity Guarantee services that may apply to certain items.

v1_beta.30.0

The getItemSnapshotFeed method now returns additional information on items listed in the feed: ecoParticipationFeeCurrency, ecoParticipationFeeValue, takeBackPolicyDescription, takeBackPolicyLabel.

These fields provide information on extended producer responsibility (EPR) regulations that may apply to the item.

v1_beta.29.1

The Item feed, Item Group feed, and Item Snapshot feed (daily and bootstrap) files are now available in the following marketplaces:

  • Austria (EBAY_AT)
  • Switzerland (EBAY_CH)

Note: To view a full list of eBay sites supported by the Feed API, see Buy API Support by Marketplace.

v1_beta.29.0

The getItemFeed method now returns additional information on items listed in the feed: ItemCreationDate, ItemWebUrl, DefaultImageUrl, ItemAffiliateWebUr, AgeGroup, Color, Pattern, Size, Gender, Material, TotalUnits.

v1_beta.28.0

The new getItemPriorityFeed method returns the daily Item Priority TSV_GZIP feed file, which allows you to track changes to the statuses of priority items within specified campaigns; e.g., added to a campaign or removed from a campaign.

The bootstrap and daily feeds include a Priority Listing attribute which you can use to track your priority listings with your Affiliate URL, utilizing the priorityListingPayload value returned in the getItemFeed payload.

v1_beta.27.0

The getItemSnapshot method now returns additional information on items listed in the feed: description, defaultImageUrl, changeMetadata, itemWebUrl, itemAffiliateWebUrl, color, size, gender, ageGroup, material, pattern, totalUnits.