recommendationsSummary

Note: This initial version of the Listing Recommendation API is not available for testing in the Sandbox environment.

This call returns a count of listing recommendations for each listing recommendation type for all active listings owned by the seller. If the seller lists items on more than one eBay site, the counts in the response will be separated by site ID. If no listing recommendations are available for any of the seller's active listings, an empty response container is returned.

recommendationsSummary Input

The recommendationsSummary HTTPS request is shown below. This call does not have any input parameters.

recommendationsSummary Output

The XML sample response in the box below lists all parameters that might be returned in the response. To learn more about an individual parameter and its possible values, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<recommendationsSummaryResponse xmlns="http://www.ebay.com/marketplace/listing/v1/service">
  <!-- Call-Specific Output Fields -->
  <recommendationsSummary>
    <recommendation>
      <type>string</type>
      <listingCount>int</listingCount>
    </recommendation>
    <!-- ... more recommendation nodes possible here ... -->
    <siteId>string</siteId>
  </recommendationsSummary>
  <!-- ... more recommendationsSummary nodes possible here ... -->
  <!-- (No Standard Output fields) -->
</recommendationsSummaryResponse>

Return Value	Type	Occurrence	Meaning

Call-Specific Output Fields �

recommendationsSummary	container	Always	The root container of the response. All listing recommendation counts for all sites are returned under the recommendationsSummary container.
recommendationsSummary.recommendation	container	Always	A container consisting of the listing recommendation type, and the number of the seller's active listings (on the site indicated in the siteId field) that have one or more listing recommendations of this type. A separate recommendation container is returned for each listing recommendation type.
recommendationsSummary.recommendation.type	string	Always	This value indicates the specific type of listing recommendation. Possible values include the following: eTRS - this recommendation type advises the seller that the listing is not meeting a specific top-rated listing requirement; ItemSpecifics - this recommendation type advises the seller that the listing is missing a required or recommended Item Specifics value; ProductIdentifier - this recommendation type advises the seller that the listing is missing the product identifier, such as Brand/MPN, UPC, ISBN or EAN; Picture - this recommendation type advises the seller that a specific picture in the listing is not meeting a specific picture quality requirement; and Price - this recommendation type provides a recommended price and/or a recommended price range for auction and fixed-price listings. These price recommendation values are based on similar items that have recently sold on eBay. Along with pricing recommendations, a recommended listing format (auction vs. fixed-price) is also returned. This recommendation type is currently only supported on the US, UK, and DE sites; Title - this recommendation type provides guidance on forming an effective listing title. The Listing Recommendation API will suggest that the listing title is missing valuable keywords, missing recommended Item Specifics, or has keywords that should not be there since it misrepresents the item. The keywords or Item Specifics are called out in the response. This recommendation type is currently only supported on the US, UK, DE, and AU sites; and FnF - this recommendation type advises the seller to offer fast handling for the item (same-day handling or handling time of 1 day) and/or offer at least one free shipping service option.
recommendationsSummary.recommendation.listingCount	int	Always	This value indicates the number of the seller's active listings (on the site indicated in the siteId field) that have one or more listing recommendations of the type indicated in the corresponding type field.
recommendationsSummary.siteId	string	Always	The string identifier of the eBay site on which the seller is listing items, such as 'EBAY-US'.

(No Standard Output fields)

recommendationsSummary Samples

Sample: Basic Call

This call retrieves a count of listing recommendations for each listing recommendation type for all active listings owned by the seller.

Description

The following call retrieves a count of listing recommendations for each listing recommendation type for all active listings owned by the seller. If the seller sells items on more than one eBay site, each set of listing recommendations is separated by site.

Input

The recommendationsSummary HTTPS GET call is always the same, and does not have any applicable input parameters.

https://svcs.ebay.com/services/selling/listingrecommendation/v1/item/recommendationsSummary

Output

As indicated by only one set of listing recommendations tied to the 'EBAY-US' site, the seller that made this call only sells items on the US site, or, that seller might sell items on another eBay site, but does not have any listing recommendations for that site.

Looking at the results, one can see that the seller has three US listings with FnF listing recommendations, one US listing with one or more ItemSpecifics listing recommendations, and one US listing with one or more Picture listing recommendations. The seller does not have any eTRS, Price, or Title listing recommendations since these listing recommendation types did not appear in the results.

{
    "recommendationsSummary": [

            "siteId": "EBAY-US",
            "recommendation": [
                {
                    "type": "ItemSpecifics",
                    "listingCount": 1
                },
                {
                    "type": "FnF",
                    "listingCount": 3
                },
                {
                    "type": "Picture",
                    "listingCount": 1
                }
            ]
        }
    ]
}

recommendationsSummary Change History

Version	Description
1.0.0 2013-04-12	(added) New call.