eBay provides catalog information, including stock photos, for some commonly sold items (e.g., an iPhone 14 Pro Max).
To include a stock photo and other product information, including Item Specifics, use the Item.ProductListingDetails container in an AddItem call.
In the Item.ProductListingDetails container, the seller passes in an eBay catalog product ID or a Global Trade Item Number (GTIN), and if a match is found in the eBay product catalog, the listing will automatically be populated with the stock photo, a listing title, a listing description, and common item specifics for the product.
Add a stock photo to a listing
Once a catalog product has been identified, the product's stock photo will automatically be included in the listing.
Note: The default value of the Item.ProductListingDetails.IncludeStockPhotoURL field is true
. Therefore, even if this field is omitted from the AddItem call, the stock photo will be used.
If a stock photo is available, it will be used at the top of the View Item page and in the Item Specifics section of the listing.
In the event that a seller does not want to include a product's stock photo, the value of Item.ProductListingDetails.IncludeStockPhotoURL must be set to false
.
If Item.ProductListingDetails.IncludeStockPhotoURL is set to false
, the stock photo does not appear in the listing at all.
In GetItem and related calls, the URL of the stock photo will be returned in Item.ProductListingDetails.StockPhotoURL.
Stock photo as gallery image
Generally, when creating a listing, the first image passed in Item.PictureDetails.PictureURL is used as the Gallery image. However, designating a stock photo for use as the Gallery image is easily achieved by configuring the following parameters as indicated:
- Item.ProductListingDetails.IncludeStockPhotoURL =
true
- Item.ProductListingDetails.UseStockPhotoURLAsGallery =
true
For information about available Gallery types, refer to Item.PictureDetails.GalleryType.