CatalogProductType

Information about an eBay catalog product.

Types that use CatalogProductType:

Call that uses one or more fields of CatalogProductType:

Fields

DetailsURL ( anyURI )
DisplayStockPhotos ( boolean )
DomainName ( string )
ItemCount ( int )
ItemSpecifics ( NameValueListArrayType )
ProductID ( ProductIDType (string) )
ProductState ( ProductStateCodeType )
ReviewCount ( int )
StockPhotoURL ( anyURI )
Title ( string )

DetailsURL ( anyURI ) [1]
Fully qualified URL for optional information about the product, such as a movie's description or film credits. This information is hosted through the eBay Web site and it cannot be edited. Portions of the content are protected by copyright. Applications can include this URL as a link in product search results so that end users can view additional descriptive details about the product. This is usually always returned when Product is returned, but it may be safest to check for the existence of this field.
See the Field Index to learn which calls use DetailsURL.

DisplayStockPhotos ( boolean ) [1]
If true, your application can attempt to display stock photos that are returned. If false, your application should not attempt to display any stock photos that are returned. This recommendation is useful for catalog data related to products like coins, where stock photos are not necessarily applicable or available. An application with a graphical user interface can use this flag to determine when to hide customized stock photo widgets. Always returned when Product is returned.
See the Field Index to learn which calls use DisplayStockPhotos.

DomainName ( string ) [1]
The name of the domain in which the product was found. If the product is mapped to multiple domains, eBay returns the most applicable domain (as determined by eBay). Always returned when Product is returned.
See the Field Index to learn which calls use DomainName.

ItemCount ( int ) [0..1]
Total number of listings on the requested eBay site that use stock information from this catalog product. This value can be greater than the number of listings returned in ItemArray. To retrieve more listings, use the Finding API. Only returned when you search by ProductID (and you pass Items or Details in IncludeSelector).
See the Field Index to learn which calls use ItemCount.

ItemSpecifics ( NameValueListArrayType ) [1]
A list of name/value pairs that are included in the product's pre-filled Item Specifics. These indicate common aspects or characteristics of the product, such as Publisher (for a book). Also see ProductID for ISBN, UPC, or EAN values, if applicable. This is usually returned. (We are not aware of any cases in which this node is not be returned. However, it may be safest to check for the existence of this node.)
See the Field Index to learn which calls use ItemSpecifics.

ProductID ( ProductIDType (string) ) [1..*]
The eBay or external IDs associated with the product. Use the Reference value as input to search for the same product in the future, or use the ISBN, EAN, or UPC value (if returned). The ISBN, EAN, and UPC values can also be useful as keys if your application is comparing products across different sites. Always returned when Product is returned.
See the Field Index to learn which calls use ProductID.

ProductState ( see ProductStateCodeType for possible values ) [0..1]
Indicates that the product has changed or will soon change (usually due to a migration from one catalog to another catalog). Typically, this field is returned for up to 90 days for a given product. After that, the product either no longer returns this field or the product is no longer returned (depending on the state change). As of mid-2008, this data is primarily applicable to catalogs used by the US, Germany, Austria, and Switzerland sites. Other sites may undergo catalog changes in the future.
See the Field Index to learn which calls use ProductState.

ReviewCount ( int ) [1]
The total number of reviews that are available for this product on the eBay Web site. This can be greater than the number of reviews returned by FindProducts. In a future release, we will provide the capability to retrieve details about reviews. Always returned when Product is returned.
See the Field Index to learn which calls use ReviewCount.

StockPhotoURL ( anyURI ) [0..1]
Fully qualified URL for a stock image (if any) that is associated with the eBay catalog product. The URL is for the image eBay usually displays in product search results (usually 70px tall). It may be helpful to calculate the dimensions of the photo programmatically before displaying it. Only returned if a URL is available for the product.
See the Field Index to learn which calls use StockPhotoURL.

Title ( string ) [1]
The title of the product, as specified in the catalog. Always returned when Product is returned.
See the Field Index to learn which calls use Title.

Copyright © 2006–2013 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.