Service/Ebay/Finding/Search/Item.php

A seller can choose to require immediate payment for Fixed Price and Buy It Now listings, including eBay Stores Inventory listings. If a Buy It Now item ends as an auction (that is, if the Buy It Now option is removed due to bids being placed on the listing), the immediate payment requirement does not apply.

The unit for distance varies by site, and is either miles or kilometers. If the country whose site you are searching uses kilometers to measure distance (for example, India/EBAY-IN), the unit is kilometers. If the site is either the US or UK, the distance unit is miles. This value is only returned for distance-based searches. You must specify a buyerPostalCode and either sort by Distance, or use a combination of the MaxDistance LocalSearch itemFilters.

The size of Gallery Plus images (up to 400 x 400 pixels) is bigger than the size of standard gallery images. In site search results, you can view the Gallery Plus image by hovering over or clicking the Enlarge link or magifying glass icon. The image uses one of the following graphics formats: JPEG, BMP, TIFF, or GIF. This field is only returned when the seller has opted for the Gallery Plus option for the given item.

The image must be provided in one of the following graphics formats: JPEG, BMP, TIF, or GIF. Returned only if the seller chose to show a gallery image.

Returns a Global ID, which is a unique identifier that specifies the combination of the site, language, and territory. In other eBay APIs (such as the Shopping API), this value is know as the site ID.

eBay generates this ID when an item is listed. ID values are unique across all eBay sites.

This gives a general indication from where the item will be shipped (or delivered).

Payment methods are not applicable to eBay Real Estate advertisement listings or other Classified Ad listing formats.

This field is returned only if a postal code has been specified by the seller. eBay proximity and local search behavior can use the combination of buyerPostalCode and postalCode values.

Note that items can be listed in more than a single category.

An eBay catalog product consists of pre-filled Item Specifics, additional descriptive information, plus a stock photo (if available). These product details are used to pre-fill item information, which is used to describe the item and can also help surface the item in searches. eBay supports the following types of product ID types: ISBN, UPC, EAN, and ReferenceID (ePID, also known as an eBay Product Reference ID). ReferenceID values are returned when available. A UPC, ISBN, or EAN product identifier will be returned only when a ReferenceID is not available. This productId value can be used as input with findItemsByProduct to retrieve items that were listed with the specified eBay catalog product. This field is only returned when a product was used to list the item.

This element is not returned if the seller did not specify a secondary category.

Only returned if SellerInfo is specified in the outputSelector field in the request.

Only returned if the item is listed in a store and StoreInfo is specified in the outputSelector field in the request.

Only returned if the seller included a subtitle for the listing.

The returned URL is optimized to support natural search. That is, the URL is designed to make items on eBay easier to find via popular internet search engines. The URL includes the item title along with other optimizations. To note, "?" (question mark) optimizes to "_W0QQ", "&" (ampersand) optimizes to "QQ", and "=" (equals sign) optimizes to "Z". Do not modify the returned URLs in your application queries (for example, eBay won't recognize the URL if you change QQ to &). In the Sandbox environment (and on the Hong Kong site), the data returned in this field is a standard ViewItem URL rather than the ViewItemURL for natural search.