Skip to main content

feed APIv1_beta.29.0

Feed API Release Notes

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.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.26.0

2021-05-04

Added a new tyreLabelImageUrl response field to the getItemSnapshotFeed method

v1_beta.25.0

2021-04-28

Added a new tyreLabelImageUrl response field to the getItemFeed method

v1_beta.24.4

2021-04-08

Added support to capture newly created listings.

v1_beta.24.3

2021-03-22

Added support for the following marketplaces in the getItemFeed, getItemGroupFeed, and getItemSnapshotFeed methods:

  • Ireland (EBAY_IE)
  • Netherlands (EBAY_NL)
  • Poland (EBAY_PL)

v1_beta.24.2

2021-02-12

Added support for three new item condition filters to the getItemFeed, getItemGroupFeed, and getItemSnapshotFeed files

v1_beta.24.1

2020-12-28

Updated the priceValue and shippingCost response field descriptions to inform of value-added tax (VAT) inclusion in applicable jurisdictions

v1_beta.24.0

2020-12-03

Added new delivery options to DeliveryOptionsEnum for getItemFeed and getItemSnapshotFeed

v1_beta.23.0

2020-11-23

Updated the occurrence to "conditional" for condition and conditionId in the getItemFeed method

v1_beta.22.0

2020-09-23

  • Added a new HTTP status code (403)
  • Added two new error messages (13023 and 13024)

v1_beta.21.0

2020-08-04

Added support for the Singapore (EBAY_SG) marketplace to the getItemFeed, getItemGroupFeed, and getItemSnapshotFeed files

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.

v1_beta.26.0

The Item Snapshot feed file (daily and bootstrap) now returns a tyreLabelImageUrl field. This field provides a URL to the image that shows the information on the tyre label.

v1_beta.25.0

The Item feed file (daily and bootstrap) now returns a tyreLabelImageUrl field. This field provides a URL to the image that shows the information on the tyre label.

v1_beta.24.4

Snapshot feeds now include new listings. You can check itemCreateDate to identify listings that were newly created within the specified hour.

v1_beta.24.3

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

  • Ireland (EBAY_IE)
  • Netherlands (EBAY_NL)
  • Poland (EBAY_PL)

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

v1_beta.24.2

Three new item condition filters are now supported by the getItemFeed, getItemGroupFeed, and getItemSnapshotFeed methods. The new values are listed in the table below.

Condition ID Condition Description
1500 NEW_OTHER The item is brand-new, unused, with no signs of wear. Packaging may be missing or opened. The item may be a factory second or have defects.
2000 CERTIFIED_REFURBISHED The item is in a pristine, like-new condition. It has been professionally inspected, cleaned, and refurbished by the manufacturer or a manufacturer-approved vendor to meet manufacturer specifications. The item will be in new packaging with original or new accessories.
2500 SELLER_REFURBISHED The item has been restored to working order by the eBay seller or a third party. This means the item was inspected, cleaned, and repaired to full working order and is in excellent condition. This item may or may not be in original packaging.

v1_beta.24.1

This release updates the descriptions of priceValue and shippingCost for the getItemFeed and getItemSnapshotFeed methods to reflect that value-added tax (VAT) is included in the cost for an item in applicable jurisdictions.

Added references to VAT to getItemFeed and getItemSnapshotFeed

The priceValue and shippingCost response field descriptions where updated to inform users that the value returned in these fields includes a value-added tax (VAT) for applicable jurisdictions when requested from supported marketplaces. In this case, users must pass the X-EBAY-C-MARKETPLACE-ID request header specifying the supported marketplace (such as EBAY_GB) to see the VAT-inclusive pricing/cost.

v1_beta.24.0

Two enumerated values have been added to DeliveryOptionsEnum for the getItemFeed and getItemSnapshotFeed methods. The new values are IN_STORE_PICKUP and PICKUP_DROP_OFF.

Enum Value Description
IN_STORE_PICKUP Indicates the buyer will pick-up the item in a store. (Local delivery option)

PICKUP_DROP_OFF

Indicates the item is dropped off or sent to a pickup location and the buyer collects the item at that location.

v1_beta.23.0

The getItemFeed method now conditionally returns the conditionId and condition fields (was always).

v1_beta.22.0

A new HTTP status code, 403, has been added in this release. This code is returned when users have insufficient permissions to access the requested marketplace or category.

The following new error messages were also added in this release: 

Error ID Error Message
13023 Insufficient permissions to access this API for the marketplace {marketplaceId}. Please contact eBay Technical Support for further assistance.
13024 Insufficient permissions to access this API for the category {category_id}. Please contact eBay Technical Support for further assistance.

v1_beta.21.0

The Item feed, Item Group feed, and Item Snapshot feed (daily and bootstrap) files are now available in the Singapore (EBAY_SG) marketplace.