CatalogProductType
Information about an eBay catalog product.

Types that use CatalogProductType:

Call that uses one or more fields of CatalogProductType:

Fields

AttributeSetID ( int )
DetailsURL ( anyURI )
DisplayStockPhotos ( boolean )
ExternalProductID ( ExternalProductIDType )
ItemCount ( int )
ItemSpecifics ( NameValueListArrayType )
ProductReferenceID ( long )
ProductState ( ProductStateCodeType )
ReviewCount ( int )
ReviewDetails ( ReviewDetailsType )
StockPhotoURL ( anyURI )
Title ( string )

AttributeSetID ( int ) [0..1]
Numeric ID for the product's domain (characteristic set). When you use GetProducts by itself, this can be useful when you want to group product results by domain (e.g., all book products together). For a mapping of attribute set IDs to names, see the eBay Web Services guide. Alternatively, use GetCategory2CS to retrieve the mappings periodically (e.g., once a day) and store them locally. (We do not recommend using the product histogram, for this purpose.)
See the Field Index to learn which calls use AttributeSetID.

DetailsURL ( anyURI ) [0..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.

Note: You can use the ProductMementoString parameter in this URL as the ProductID value in GetSearchResults requests. This parameter is a colon-delimited alphanumeric value. For an example of how to use this string, see the GetProducts samples in the eBay Web Services guide.
See the Field Index to learn which calls use DetailsURL.

DisplayStockPhotos ( boolean ) [0..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.
See the Field Index to learn which calls use DisplayStockPhotos.

ExternalProductID ( ExternalProductIDType ) [0..1]
An ISBN, UPC, or EAN value that is associated with this eBay catalog product (if any). These values are only returned for products in "media" domains (Books, DVDs and Movies, Music, and Video Games). Products in other domains don't return this value (even if a UPC is available in the Item Specifics.) Please note that as of February 2007, GetProducts may temporarily return two ExternalProductID nodes for ISBN for some sites (one with a 13-digit value and one with a 10-digit value). This is a bug and it will be fixed in an upcoming release. Instead, one ExternalProductID node will be returned with an additional field. Do not code your application to expect multiple ExternalProductID nodes to be returned for ISBN values on an ongoing basis.
See the Field Index to learn which calls use ExternalProductID.

ItemCount ( int ) [0..1]
Total number of listings on the specified 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 GetSearchResults. Only returned when you use ExternalProductID or ProductReferenceID and you set IncludeItemArray to true.
See the Field Index to learn which calls use ItemCount.

ItemSpecifics ( NameValueListArrayType ) [0..1]
A list of attribute and value pairs that are included in the product's pre-filled Item Specifics. Also see ExternalProductID for ISBN, UPC, or MPN 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.

ProductReferenceID ( long ) [0..1]
The numeric ID for the eBay catalog product. After selecting a product returned from a keyword query, pass this value in GetProducts to retrieve more information about that product.
See the Field Index to learn which calls use ProductReferenceID.

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

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 ) [0..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 GetProducts. See ReviewDetails.Review.URL for information about viewing more reviews.
See the Field Index to learn which calls use ReviewCount.

ReviewDetails ( ReviewDetailsType ) [0..1]
The product's most helpful reviews, if any. The reviews are sorted by most helpful review (most votes) first. Only returned when you pass in ExternalProductID or ProductReferenceID and you set IncludeReviewDetails to true. Up to 20 of the reviews are returned. If more reviews are available, (that is, if ReviewCount is greater than 20), the user can look at additional reviews on the eBay Web site. See ReviewDetails.Review.URL for information about viewing more reviews.
See the Field Index to learn which calls use ReviewDetails.

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.
See the Field Index to learn which calls use StockPhotoURL.

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

This document was generated with a customized version of the apireferencedocs tool.

© 2005–2010 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.