itemRecommendations

A seller can use this call to return an array of listing recommendations for a specific active or ended listing. It is up to the seller about whether to retrieve listing recommendations of all types, or to retrieve listing recommendations of a specific type, or types.

If there are no listing recommendations available for the specified listing, an empty (no data) itemRecommendationsResponse container is returned. A seller can only request listing recommendations for their own listings. If the seller passes in an Item ID value for a listing that does not belong to him/her, an error is returned.

Back to top

itemRecommendations Input

The seller's itemId value is required as part of the path for this call (see the actual Item ID value in sample call below).

An example of a itemRecommendations HTTPS request (with the single recommendationType query parameter) is shown below. To learn more about the recommendationType query parameter and its possible values, click its name in the sample call (or scroll down to find it in the table).

See also Samples.

https://svcs.ebay.com/services/selling/listingrecommendation/v1/item/140904540796/itemRecommendations/?recommendationType=eTRS,Picture

Back to top

itemRecommendations 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"?>
<itemRecommendationsResponse xmlns="http://www.ebay.com/marketplace/listing/v1/service">
  <!-- Call-Specific Output Fields -->
  <itemId>string</itemId>
  <recommendation>
    <code>string</code>
    <fieldName>string</fieldName>
    <group>string</group>
    <message>string</message>
    <recommendationData>
      <appliesTo>string</appliesTo>
      <currency>string</currency>
      <maxRecommendedValue>string</maxRecommendedValue>
      <minRecommendedValue>string</minRecommendedValue>
      <similarItems>string</similarItems>
      <!-- ... more similarItems fields possible here ... -->
    </recommendationData>
    <type>string</type>
    <value>string</value>
    <!-- ... more value fields possible here ... -->
  </recommendation>
  <!-- ... more recommendation nodes possible here ... -->
  <!-- (No Standard Output fields) -->
</itemRecommendationsResponse>

Back to top

itemRecommendations Samples

This call retrieves listing recommendations for an eBay listing.

Description

The following call retrieves all listing recommendations of all types for the eBay listing with an Item ID of '221209137374'. The seller making this call must own this listing or an error will be returned.

Input

The following itemRecommendations HTTPS GET call retrieves all listing recommendations of all types for eBay Item# 221209137374.

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

Output

The JSON call response include three listing recommendations.

The 'ItemsSpecifics' listing recommendation is telling the seller that 'Color' is a recommended Item Specifics for the item's category. For this 'ItemSpecifics' listing recommendation, there were no suggested values for the 'Color' Item Specifics. To improve the listing based on this listing recommendation, the seller would perform a ReviseItem/ReviseFixedPriceItem call, passing in the 'Color' Item Specific and the actual color of the item through the ItemSpecifics.NameValueList container.

The 'Picture' listing recommendation is telling the seller that the picture stored at the URL specified in the fieldName field is not meeting the eBay Picture Resolution standard, which requires that pictures in listing are at least 500 pixels on the longest side. To improve the listing based on this listing recommendation, the seller would upload a revised picture (at least 500 pixels on the longest side) to the URL specified in the fieldName field, and then perform a ReviseItem/ ReviseFixedPriceItem call, passing in the URL of the image through the PictureURL field in the PictureDetails container.

The two 'FnF' listing recommendations are suggesting that the seller offer same-day or 1-day handling and offer at least one free shipping service option, so that the listing will qualify as a Fast 'N Free listing. To improve the listing based on this listing recommendation, the seller would perform a ReviseItem/ReviseFixedPriceItem call, including the Item.DispatchTimeMax field in the request and setting its value to '0' or '1', and setting the FreeShipping boolean value to 'True' in at least one ShippingServiceOptions container.

{
    "itemId": 221209137374,
    "Recommendation":
        {
            "type": "ItemSpecifics",
            "group": "ITEM_SPECIFICS",
            "fieldName": "Color",
            "code": "RECOMMENDED_FIELD_VALUE_MISSING"
        },
        {
            "type": "Picture",
            "group": "PICTURE_RESOLUTION",
            "fieldName": "http://i.ebayimg.com/00/s/MTg2WDMwMA==/z/OMMAAOxyZw5RaEq-/$T2eC16R,!yUE9s6NFIJdBR,Eq95-Sg~~60_1.JPG?set_id=8800004005",
            "code": "RECOMMENDED_STANDARDS_NOT_MET",
            "message": ": To improve your chances of selling this item, upload a larger photo that is at least 500 pixels on the longest side.
            Later this year, all listings will require this, so please update all your photos to this size at a minimum. Not doing so will violate
            our policy on photos and could result in a listing being removed."
        },
        {
            "type": "FnF",
            "group": "SHIPPING",
            "fieldName": "ShipsWithinDays",
            "code": "FIELD_VALUE_RECOMMENDATION",
            "message": ": Offer same day or 1-day handling time."
        },
        {
      "type": "FnF",
      "group": "SHIPPING",
      "fieldName": "ShippingServiceCost",
      "code": "FIELD_VALUE_RECOMMENDATION",
      "message": ": Offer free shipping."
        }
    ]
}

Back to top

itemRecommendations Change History