catalog APIv1_beta.2.0

SuggestedProduct

This type contains the full details of a suggested product, including information about the product's identifiers, description, product images, categories, and aspects.

Types that use SuggestedProduct

Calls that use SuggestedProduct

Fields

Field
Type
Description
additionalImageUrls
array of string
A list of URLs for additional images associated with the suggested product. For the URL of the primary image, see the imageUrl field.
aspects
array of ProductAspect
Contains one or more category aspects and their values that are associated with the suggested product.
brand
The manufacturer's brand name for the suggested product.
description
A rich description of the suggested product, which can contain HTML, including the following basic tags:
  • Text formatting tags such as <b>, <i>, <br>, <ol>, <ul>, and <li>
  • Table formatting tags such as <table>, <tr>, <td>, <th>, <thead>, <tfoot>, <tbody>, <caption>, <col>, and <colgroup>
Note: Active content from sellers is prohibited on eBay, including animation or video via JavaScript, Flash, plug-ins, or form actions.
ean
array of string
A list of all European Article Numbers (EANs) that identify the suggested product.
epid
Required or returned only if the value of the changeRequestType field is PRODUCT_UPDATE. This is the eBay product ID of the product record for which an update is being suggested.
imageUrl
Required or returned if the value of the changeRequestType field is PRODUCT_CREATION. This is the URL of the primary image associated with the suggested product.
isbn
array of string
A list of all International Standard Book Numbers (ISBNs) that identify the suggested product.
mpn
array of string
A list of all Manufacturer Product Number (MPN) values that the manufacturer uses to identify the suggested product.
otherApplicableCategoryIds
array of string
A list of category IDs (other than the value of primaryCategoryId) for all the leaf categories to which the suggested product might belong.
primaryCategoryId
The identifier of the category that eBay recommends using to list the suggested product, based on previous listings of similar products. Products in the eBay catalog are not automatically associated with any particular category, but using an inappropriate category can make it difficult for prospective buyers to find the product. For other possible categories that might be used, see otherApplicableCategoryIds.
title
The catalog title that will be used as the listing title for all item listings based on the suggested product.
upc
array of string
A list of all Universal Product Codes (UPCs) that identify the suggested product.
version
Required or returned only if the value of changeRequestType is PRODUCT_UPDATE. This is the current version number in the catalog of the product record for which an update is being suggested.