feed APIv1_beta.17.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.17.0

2019-10-07

Added columns for price per unit information.

v1_beta.16.0

2019-09-10

Added columns for shipping information.

v1_beta.15.0

2019-07-08

2019-05-15
The feed files no longer include non-Good 'Til Cancelled items and the documentation has been updated.

Added columns for package size and weight to the Item Feed (daily and bootstrap)

v1_beta.14.0

2019-04-16

Added support for the AU, ES, FR, IT marketplaces

2019-03-27
  • Returns items in used condition
  • Returns items from Above Standard sellers
2019-03-04 Added an HTTP status code and changed error 13006

v1_beta.13.0

2019-02-12 Added a column for lot size to the getItemFeed and getItemSnapshotFeed files

v1_beta.12.0

2019-01-23
  • Added a column for qualified programs to the getItemFeed and getItemSnapshotFeed files
  • Added a new error message for unsupported categories

 

v1_beta.17.0

The following columns were added to the Item Feed (daily and bootstrap) and snapshot files. These fields provide the price per unit information.

Column Name

Type

Description

unitPricingMeasure string The designation, such as size, weight, volume, count, etc., that was used to specify the quantity of the item. This helps buyers compare prices.

For example, the following tells the buyer that the item is 7.99 per 100 grams.

"unitPricingMeasure": "100g",
"unitPrice": {
  "value": "7.99",
  "currency": "GBP"
unitPrice string This is the price per unit for the item. Some European countries require listings for certain types of products to include the price per unit so buyers can accurately compare prices.

For example:

"unitPricingMeasure": "100g",
"unitPrice": {
  "value": "7.99",
  "currency": "GBP"

v1_beta.16.0

The following columns were added to the Item Feed (daily and bootstrap) and snapshot files. These return shipping information for the item.

Column Name

Type

Description

shippingCostType string Indicates the class of the shipping cost.

Valid Values: FIXED or CALCULATED
shippingCost string The final shipping cost for all the items after all discounts are applied.
additionalShippingCostPerUnit string Any per item additional shipping costs for a multi-item purchase. For example, let's say the shipping cost for a power cord is $3. But for an additional cord, the shipping cost is only $1. So if you bought 3 cords, the shippingCost would be $3 and this value would be $2 ($1 for each additional item).
quantityUsedForEstimate integer The number of items used when calculating the shipping estimation information.
shippingCarrierCode string The name of the shipping provider, such as FedEx, or USPS.
shippingServiceCode string The type of shipping service. For example, USPS First Class.
shippingType string The type of a shipping option, such as EXPEDITED, ONE_DAY, STANDARD, ECONOMY, PICKUP, etc.

 

v1_beta.15.0

The following columns were added to the Item Feed (daily and bootstrap) files. These return the weight and dimensions of the item's package.

Column Name

Type

Description

lengthUnitOfMeasure LengthUnitOfMeasureEnum The unit of measurement used for the package dimensions, such as INCH, FEET, CENTIMETER, or METER.

Code so that your app gracefully handles any future changes to this list.
packageWidth string The width of the shipping package that contains the item.
packageHeight string The height of the shipping package that contains the item.
packageLength string The length of the shipping package that contains the item.
weightUnitOfMeasure WeightUnitOfMeasureEnum The unit of measurement used for the package weight, such as POUND, KILOGRAM, OUNCE, or GRAM.

Code so that your app gracefully handles any future changes to this list.
packageWeight string The weight of the package that contains the item.

 

v1_beta.14.0

2019-03-16

The feed files are now available for the following marketplaces:

  • EBAY_AU - Australia (ebay.com.au)
  • EBAY_ES - Spain (ebay.es)
  • EBAY_FR - France (ebay.fr)
  • EBAY_IT - Italy (ebay.it)

2019-03-27

The following changes have been made.

Returns items in used condition

Now the feed files will contain items in New (ID 1000) or Used (ID 3000) condition. You can add your own filter to control the condition of the items you want.

Returns items from Above Standard sellers

The feed files now contain items from Top Rated sellers and Above Standard sellers. For more information about these seller levels, see the eBay help page Seller levels and performance standards.

2019-03-04

The following changes have been made.

Added 204 HTTP Status Code This code is returned when there are no items that meet the criteria for this feed file. See Feed File Filters for details.
Changed ID 13006 For error ID 13006 the category was changed from REQUEST to APPLICATION.

 

v1_beta.13.0

Added the lotSize column to the Item and Item Snapshot feed files. This column returns the number of items in a lot.  In other words, a lot size is the number of items that are being sold together. 

A lot is a set of two or more items included in a single listing that must be purchased together in a single order line item. All the items in the lot are the same but there can be multiple items in a single lot, such as the package of batteries shown in the example below.

For example

Item

Lot Definition

Lot Size

A fashion jewelry ring

A package of 100 assorted rings

100

A P235/75-15 Goodyear tire

A set of 4 tires

4

A package of 24 AA batteries

A box of 10 packages

10

 

Note: Lots are not supported in all categories.

 

v1_beta.12.0

Added the qualifiedPrograms column to the Item and Item Snapshot feed files. This column is a pipe separated list of the qualified programs available for the item. The only qualified program returned is EBAY_PLUS.

Note: EBAY_PLUS is supported only on the EBAY_DE and EBAY_AU marketplaces. This means the qualifiedPrograms column will be populated only in feed files for these marketplaces. Currently, only EBAY_DE feed files are available. For a list of marketplaces supported by the Feed API, see Buy API Support by Marketplace.

The following error message has been added. The Feed API does not support all the eBay categories. For example, there are no feed files for the real estate category. This error appears when the category ID is valid for the marketplace, but the Feed API does not support that category.

Error ID

Error Message

13022

The 'category_id' {category_id} submitted is not supported.