Skip to main content

Response fields

Response field descriptions

Output container/fieldTypeDescription
itemIdstring

The unique identifier of the listing in eBay RESTful format. For a single-variation listing, an example would be v1|1**********2|0. For a multiple-variation listing, an example would be v1|1**********2|4**********2, with the first set of numbers identifying the listing, and the second set of numbers identifying a specific variation within that listing.

Occurrence: Always

titlestring

The title of the listing. This title can be created by the seller, or it may be the title used by an eBay catalog product if the seller listed the product based off of an eBay catalog product.

Note that if a listing title has special characters in it, such as double quote marks, you may see a backslash character to escape these special characters.

Max length: 80 characters (not including escape characters).

Occurrence: Always

descriptionstring

The listing descripton. This description can be created by the seller, or it may be the description used by an eBay catalog product if the seller listed the product based off of an eBay catalog product.

Unlike some other APIs like the GetItem call in the Trading API, the description returned in this field is only text (no HTML or CSS markup), and is limited to 1024 characters. A listing description that is longer than 1024 characters will be truncated.

Max length: 1024 characters

Occurrence: Always

imageUrlstring

A list of URLs to all images that are defined for the listing.

Occurrence: Always

itemWebUrlstring

The URL of the View Item page of the listing or item variation within the listing.

Occurrence: Always

availabilityAvailabilityEnum

This enumeration value will indicate whether quantity of the item is still available for purchase. See the AvailabilityEnum type description for more information on what each value indicates.

Occurrence: Always

conditionstring

Text describing the condition of the item. For a list of item condition values (and their numeric IDs), see the Item Condition IDs and Names page.

Occurrence: Conditional

priceValuestring

The price of the item.

Occurrence: Always

priceCurrencyCurrencyCodeEnum

The currency used for the price of the item. Generally, this is the currency used by the country of the eBay marketplace offering the item.

Occurrence: Always

gtinstring

The unique Global Trade Item Number of the item. This can be a UPC (Universal Product Code) value, an EAN (European Article Number) value, or an ISBN (International Standard Book Number) value.

Occurrence: Conditional

mpnstring

This value is the Manufacturer Part Number (MPN). An MPN value must always be paired with a brand value to make it a valid identifier. So, if a product has an MPN value, the brand value should also be referenced.

Occurrence: Conditional

brandstring

The brand of the product. A value for this field will only be returned if 'Brand' is a defined item specific for the listing.

Occurrence: Conditional

defaultImageUrlstring

The URL of the gallery image.

Occurrence: Always

ageGroupstring

The age group(s) that the product is intended for. A value for this field will only be returned if age/age level/age range/age group is a defined item specific for the listing. The item specifics in the actual listing will most likely use age values/ranges, but the Buy Feed API maps these age values/ranges to the following values: newborn, infant, toddler, kids, or adult.

Occurrence: Conditional

colorstring

The color of the item. A value for this field will only be returned if 'Color' is a defined item specific or variation specific for the listing.

Occurrence: Conditional

genderstring

The specified gender that the item is intended for. A value for this field will only be returned if 'Gender' is a defined item specific or variation specific for the listing.

Occurrence: Conditional

materialstring

The material used for the product. A value for this field will only be returned if 'Material' is a defined item specific for the listing.

Occurrence: Conditional

categoryIdstring

The unique identifier of the listing category.

Occurrence: Always

categorystring

The name of the listing category.

Occurrence: Always

epidstring

This value is the eBay Product Identifier (ePID). Each eBay catalog product has a unique ePID value.

Occurrence: Conditional

unitPricingMeasurestring

This field shows the measurement used for unit pricing. In unit pricing, the unit price per weight, per volume, or per count is shown. An example would be 100 ml. And for this value to mean something, the user must also look at the unitPrice field, which will show the price per 100 ml. So, if the unitPrice value is 6.8 EUR, the unit price will be 6.8 EUR per 100 ml. This field is only applicable for eBay marketplaces and categories that support unit pricing. This feature helps buyers compare prices across products/brands.

Occurrence: Conditional

totalUnitsstring

For an item that is priced by weight or length, this field shows the total number of units that are sale for one quantity of the item. For example, if the item is priced by weight, this field might show a value of 1.0 and the unitType field might show a value of POUND, meaning one quanity of the item has a weight of 1 pound. If the item is priced by length, this field might show a value of 1.0 and the unitType field might show FOOT, meaning one quanity of the item has a length of 1 foot.

Occurrence: Conditional

unitPricestring

This field shows the price per weight, per volume, or per count of the item. For this value to mean something, the user must also look at the unitPricingMeasure field, which will show the weight/volume/count measurement unit such as 100 ml. So, if the unitPrice value is 6.8 EUR, the unitPricingMeasure value is 100 ml, the unit price will be 6.8 EUR per 100 ml. This field is only applicable for eBay marketplaces and categories that support unit pricing. This feature helps buyers compare prices across products/brands.

Occurrence: Conditional

handlingTimeinteger

This integer value states the seller's handling time in number of business days. The seller is expected to physically ship the item within the handling time window, and the 'clock' starts as soon as the buyer pays for the item. For example, if the buyer pays for the item during the seller's business hours on a Wednesday, and the handlingTime is 1, the seller will be expected to ship the item on Thursday (the next day). Supported handling times will vary by eBay categories, but in most cases, Top Rated Sellers are expected to set a handling time of 0 or 1. If the handling time is set to 0, this indicates that the seller supports 'same-day shipping', but the buyer must complete the purchase of the item before the seller's stated same-day shipping cutoff time in order for the item to be shipped out on the same day as purchase.

Occurrence: Conditional

minEstimatedDeliveryDaysinteger

The shortest expected delivery time (in business days after payment) that the buyer can expect delivery of the item. This value is calculated by adding together the seller's handling time and the lower threshold value of the fastest shipping service option available for the listing.

Occurrence: Conditional

maxEstimatedDeliveryDaysinteger

The longest expected delivery time (in business days after payment) that the buyer can expect delivery of the item. This value is calculated by adding together the seller's handling time and the higher threshold value of the slowest shipping service option available for the listing.

Occurrence: Conditional

returnsAcceptedboolean

A value of true here indicates that returns are accepted for the item, and a value of false here indicates that the seller does not accept returns for the item. Please note that a seller must accept a return in the case of an item that a buyer marks as 'not as described' in the listing.

Occurrence: Always

returnPeriodValueinteger

The number of days that the buyer has to return the item after the purchase date. For example, if this value is 30, the buyer has 30 days to return the item for a refund. Return periods can vary by eBay marketplace and listing category, but typical return periods are 30 and 60 days.

A value should always be returned for this field if returns are accepted for the item, but will be returned empty if the seller does not accept (buyer remorse) returns.

Occurrence: Conditional

freeReturnboolean

A value of true here indicates that an item can be returned to the seller free of charge (seller pays for return shipping label), and a value of false here indicates that the buyer is responsible for return shipping charges (except in the case of 'significantly not as described' item).

Occurrence: Always

qualifiedProgramsstring

A pipe separated list of eBay programs that the listing qualifies for, such as EBAY_PLUS and AUTHENTICITY_GUARANTEE.

eBay Plus is a premium account option for buyers, which provides benefits such as fast and free domestic shipping and free returns on selected items. eBay Plus is available only to buyers in Germany, Austria, and Australia marketplaces.

The eBay Authenticity Guarantee program enables third-party authenticators to perform authentication verification inspections on items such as luxury watches, collectible sneakers, or high-end handbags.

Occurrence: Conditional

sellerTrustLevelSellerTrustLevelEnum

This enumeration value indicates the trust level rating of the seller. An empty value in this field may indicate that the eBay marketplace does not use these seller trust levels, or that the seller has a different rating other than the ones defined in the SellerTrustLevelEnum type.

Occurrence: Conditional

shippingCoststring

The cost to ship the item using the cheapest shipping service option available for the item. Unless the seller uses flat-rate shipping and charges the same price to ship the item to all locations where he/she is willing to ship, the actual shipping cost will vary based on where the buyer is located.

Some sellers will offer a free shipping option, and if that is the case, the value returned here will be 0.0.

Occurrence: Conditional