f
 

Searching by Product

Within the context of eBay, a product is stock information from a catalog. A seller can take this product data and use it to pre-fill some of the details in their listings. (We call this Pre-filled Item Information.) For example, a seller can list a book using the book's ISBN and the listing will automatically include a stock photo of the book, the listing title will include the title of the book and the name of the author, and details about the book will be included in the item specifics.

For example, if you search the eBay site for "harry potter and the chamber of secrets," the site will return some product matches in addition to matching items. If you follow one of the book links to a product details page, you will see information about the product, such as author, publisher, publication date, and ISBN. This information comes from the Books catalog. The product details page also displays listings that contain data matching the product.

The following link will open the product details page for the hard cover edition of Harry Potter and the Chamber of Secrets.

http://catalog.ebay.com/Harry-Potter-and-the-Chamber-of-Secrets_0439064864_9780439064866_W0QQ_fifptsZ1QQ_pcatidZ4QQ_pidZ228742QQ_trksidZp3286Q2ec0Q2em271

You can use the findItemsByProduct call to search for items that contain data matching a specified product. This call requires a product ID and the ID type. The Finding API supports the following product ID types:

  • ReferenceID—a global reference ID for an eBay catalog product
  • ISBN—the 10 or 13-digit International Standard Book Number
  • UPC—the Universal Product Code, a numeric value associated with barcodes
  • EAN—the European Article Number, a numeric value associated with barcodes

 

If you do not know the product ID, use FindProducts in the Shopping API to retrieve a list of catalog products. Obtain the product ID from one of these products and use it as input to findItemsByProduct to find all items that were listed based on that product.