Browse API v1_beta.5.0 Release Note Appendix

Get Item call examples

Get Item by Legacy Id call JSON response

url:
https://api.ebay.com/buy/browse/v1/item/get_item_by_legacy_id?legacy_item_id=112259821206&legacy_variation_id=412674842751

{
  "itemId": "v1|112259821206|412674842751",
  "title": "APPLE IPHONE SE 16GB 64GB GSM Worldwide GSM Unlocked Smartphone ",
  "subtitle": "Ships Next Business Day!MAY COME W PARTIAL APPLE CARE!!",
  "shortDescription": "Apple iPhone SE - 16/64GB - Space gray, Silver, Gold, Rose Gold. The iPhone SE features a 1136 x 640 pixel multi-touch ...",
  "price": {
    "value": "311.50",
    "currency": "USD"
  },
  "categoryPath": "Cell Phones & Accessories|Cell Phones & Smartphones",
  "condition": "New",
  "itemLocation": {
    "city": "New Holland",
    "stateOrProvince": "Pennsylvania",
    "postalCode": "17557",
    "country": "US"
  },
  "image": {
    "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/ylkAAOSw44BYb~Qm/$_57.JPG?set_id=8800005007"
  },
  "additionalImages": [
    {
      "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/2j0AAOSwA3dYb~Qd/$_57.JPG?set_id=8800005007"
    },
    {
      "imageUrl": "http://i.ebayimg.com/00/s/ODAwWDgwMA==/z/~PIAAOSwa~BYbrG3/$_57.JPG?set_id=8800005007"
    }
  ],
  "color": "Gold",
  "brand": "Apple",
  "itemEndDate": "2017-04-05T21:02:48.000Z",
  "seller": {
    "username": "mobile_legacy",
    "feedbackPercentage": "98.5",
    "feedbackScore": 4662
  },
  "mpn": "MLY32LL/A",
  "estimatedAvailabilities": [
    {
      "deliveryOptions": [
        "SHIP_TO_HOME"
      ],
      "availabilityThresholdType": "MORE_THAN",
      "availabilityThreshold": 10,
      "estimatedAvailabilityStatus": "IN_STOCK",
      "estimatedSoldQuantity": 53
    }
  ],
  "shippingOptions": [
    {
      "shippingServiceCode": "USPS First Class Package",
      "trademarkSymbol": "®",
      "shippingCarrierCode": "USPS",
      "type": "Standard Shipping",
      "shippingCost": {
        "value": "0.00",
        "currency": "USD"
      },
      "quantityUsedForEstimate": 1,
      "minEstimatedDeliveryDate": "2017-03-30T10:00:00.000Z",
      "maxEstimatedDeliveryDate": "2017-03-30T10:00:00.000Z",
      "shipToLocationUsedForEstimate": {
        "postalCode": "19406",
        "country": "US"
      },
      "additionalShippingCostPerUnit": {
        "value": "0.00",
        "currency": "USD"
      },
      "shippingCostType": "FIXED"
    },
    {
      "shippingServiceCode": "USPS Priority Mail",
      "trademarkSymbol": "®",
      "shippingCarrierCode": "USPS",
      "type": "Expedited Shipping",
      "shippingCost": {
        "value": "5.00",
        "currency": "USD"
      },
      "quantityUsedForEstimate": 1,
      "minEstimatedDeliveryDate": "2017-03-30T10:00:00.000Z",
      "maxEstimatedDeliveryDate": "2017-03-30T10:00:00.000Z",
      "shipToLocationUsedForEstimate": {
        "postalCode": "19406",
        "country": "US"
      },
      "additionalShippingCostPerUnit": {
        "value": "3.00",
        "currency": "USD"
      },
      "shippingCostType": "FIXED"
    },
    {
      "shippingServiceCode": "FedEx 2Day",
      "trademarkSymbol": "®",
      "shippingCarrierCode": "FedEx",
      "type": "Expedited Shipping",
      "shippingCost": {
        "value": "20.00",
        "currency": "USD"
      },
      "quantityUsedForEstimate": 1,
      "minEstimatedDeliveryDate": "2017-03-30T10:00:00.000Z",
      "maxEstimatedDeliveryDate": "2017-03-30T10:00:00.000Z",
      "shipToLocationUsedForEstimate": {
        "postalCode": "19406",
        "country": "US"
      },
      "additionalShippingCostPerUnit": {
        "value": "10.00",
        "currency": "USD"
      },
      "shippingCostType": "FIXED"
    }
  ],
  "returnTerms": {
    "returnsAccepted": true,
    "refundMethod": "MONEY_BACK",
    "returnShippingCostPayer": "BUYER",
    "returnPeriod": {
      "value": 30,
      "unit": "CALENDAR_DAY"
    }
  },
  "localizedAspects": [
    {
      "type": "STRING",
      "name": "Color",
      "value": "Gold"
    },
    {
      "type": "STRING",
      "name": "GB",
      "value": "16GB"
    },
    {
      "type": "STRING",
      "name": "Model",
      "value": "iPhone SE"
    },
    {
      "type": "STRING",
      "name": "Lock Status",
      "value": "Network Unlocked"
    },
    {
      "type": "STRING",
      "name": "Contract",
      "value": "without Contract"
    },
    {
      "type": "STRING",
      "name": "Cellular Band",
      "value": "GSM"
    },
    {
      "type": "STRING",
      "name": "Storage Capacity",
      "value": "16GB 64GB"
    },
    {
      "type": "STRING",
      "name": "Style",
      "value": "smartphone"
    },
    {
      "type": "STRING",
      "name": "MPN",
      "value": "MLY32LL/A"
    },
    {
      "type": "STRING",
      "name": "Operating System",
      "value": "ios"
    },
    {
      "type": "STRING",
      "name": "Brand",
      "value": "Apple"
    },
    {
      "type": "STRING",
      "name": "Network",
      "value": "Unlocked"
    },
    {
      "type": "STRING",
      "name": "Network Technology",
      "value": "GSM"
    }
  ],
  "description": "<font rwr='1' size='4' ... We are happy to offer a 30 day warranty on all products, and we never charge a restocking fee. ...",
  "buyingOptions": [
    "FIXED_PRICE"
  ],
  "itemAffiliateWebUrl": "http://rover.api.ebay.com/rover/1/711-53200-19255-0/1?campid=5337984774&customid=&toolid= ...",
  "itemWebUrl": "http://www.api.ebay.com/itm/APPLE-IPHONE-SE-16GB-64GB-GSM-Worldwide-GSM-Unlocked-Smartphone-/112259821206?var=412674842751&src=urllib",
  "shipToLocations": {
    "regionIncluded": [
      {
        "regionName": "United States",
        "regionType": "COUNTRY"
      },
      {
        "regionName": "Canada",
        "regionType": "COUNTRY"
      },
      {
        "regionName": "United Kingdom",
        "regionType": "COUNTRY"
      },
      {
        "regionName": "Denmark",
        "regionType": "COUNTRY"
      },
      {
        "regionName": "Romania",
        "regionType": "COUNTRY"
      },
      ...
      {
        "regionName": "Reunion",
        "regionType": "COUNTRY"
      }
    ]
  },
  "primaryItemGroup": {
    "itemGroupId": "112259821206",
    "itemGroupType": "SELLER_DEFINED_VARIATIONS",
    "itemGroupHref": "https://api.api.ebay.com/buy/browse/v1/get_items_by_item_group?item_group_id=112259821206",
    "itemGroupTitle": "APPLE IPHONE SE 16GB 64GB GSM Worldwide GSM Unlocked Smartphone ",
    "itemGroupImage": {
      "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/Dg8AAOSwnHZYcAAg/$_57.JPG?set_id=8800005007"
    },
    "itemGroupAdditionalImages": [
      {
        "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/8lYAAOSwA3dYcAA5/$_57.JPG?set_id=8800005007"
      },
      {
        "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/AOIAAOSwUKxYcAAn/$_57.JPG?set_id=8800005007"
      },
      {
        "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxMjAw/z/~1UAAOSwUKxYcAAa/$_57.JPG?set_id=8800005007"
      }
    ]
  }
}

 

 

Get Item by Item Group call JSON response 

url:
https://api.ebay.com/buy/browse/v1/item/get_items_by_item_group?item_group_id=112259821206

{
  "items": [
    {
      "itemId": "v1|321196149534|510153352420",
      "title": " 3/4 Sleeve  Plain T-Shirt Lot Baseball  Raglan Jersey Sports Fashion Casual Tee",
      "shortDescription": "Quantity : 1 pc Baseball ( Raglan ) T-Shirts. Double Stitched Neck & Arm Bottom Hem for Durability. T Shirt Size / ...",
      "price": {
        "value": "5.99",
        "currency": "USD"
      },
      "categoryPath": "Clothing, Shoes & Accessories|Men's Clothing|Athletic Apparel",
      "condition": "New with tags",
      "itemLocation": {
        "city": "Los Angeles",
        "stateOrProvince": "California",
        "postalCode": "90019",
        "country": "US"
      },
      "image": {
        "imageUrl": "http://i.ebayimg.com/00/s/MTAwMFgxMDAw/z/ ... kLBSHpsIm9kw~~60_1.JPG?set_id=880000500F"
      },
      "color": "Black / Heather Charcole Gray",
      "material": "100% Cotton",
      "sizeType": "Regular",
      "brand": "Youroutfitter90210",
      "itemEndDate": "2017-04-10T01:09:42.000Z",
      "seller": {
        "username": "yourcloset90210",
        "feedbackPercentage": "99.7",
        "feedbackScore": 69497
      },
      "estimatedAvailabilities": [
        {
          "deliveryOptions": [
            "SHIP_TO_HOME"
          ],
          "availabilityThresholdType": "MORE_THAN",
          "availabilityThreshold": 10,
          "estimatedAvailabilityStatus": "IN_STOCK",
          "estimatedSoldQuantity": 822
        }
      ],
      "shippingOptions": [
        {
          "shippingServiceCode": "Standard Shipping",
          "type": "Standard Shipping",
          "shippingCost": {
            "value": "2.99",
            "currency": "USD"
          },
          "quantityUsedForEstimate": 1,
          "minEstimatedDeliveryDate": "2017-04-03T10:00:00.000Z",
          "maxEstimatedDeliveryDate": "2017-04-03T10:00:00.000Z",
          "shipToLocationUsedForEstimate": {
            "postalCode": "19406",
            "country": "US"
          },
          "additionalShippingCostPerUnit": {
            "value": "1.99",
            "currency": "USD"
          },
          "shippingCostType": "FIXED"
        }
      ],
      "returnTerms": {
        "returnsAccepted": true,
        "refundMethod": "MONEY_BACK",
        "returnMethod": "EXCHANGE",
        "returnShippingCostPayer": "BUYER",
        "returnPeriod": {
          "value": 30,
          "unit": "CALENDAR_DAY"
        },
        "restockingFeePercentage": "20"
      },
      "localizedAspects": [
        {
          "type": "STRING",
          "name": "Size (Men's)",
          "value": "S"
        },
        {
          "type": "STRING",
          "name": "Color",
          "value": "Black / Heather Charcole Gray"
        },
        {
          "type": "STRING",
          "name": "Brand",
          "value": "Youroutfitter90210"
        },
        {
          "type": "STRING",
          "name": "Material",
          "value": "100% Cotton"
        },
        {
          "type": "STRING",
          "name": "Style",
          "value": "Shirts & Tops Raglan Baseball Jersey Tee"
        },
        {
          "type": "STRING",
          "name": "Sleeve Length",
          "value": "Short Sleeve"
        },
        {
          "type": "STRING",
          "name": "Size Type",
          "value": "Regular"
        },
        {
          "type": "STRING",
          "name": "Sleeve Length Detail",
          "value": "3/4 Sleeves"
        },
        {
          "type": "STRING",
          "name": "Sport",
          "value": "Gymnastics, Skateboarding, Auto Racing, Baseball & Softball, Bowling, Camping & Hiking, ..."
        }
      ],
      "buyingOptions": [
        "FIXED_PRICE"
      ],
      "itemAffiliateWebUrl": "http://rover.api.ebay.com/rover/1/711-53200-19255-0/1?campid=5337984774&customid=&toolid=...",
      "itemWebUrl": "http://www.api.ebay.com/itm/3-4-Sleeve-Plain-T-Shirt-Lot-Baseball-Raglan-Jersey-Sports ...",
      "shipToLocations": {
        "regionIncluded": [
          {
            "regionName": "Worldwide",
            "regionType": "WORLDWIDE"
          }
        ]
      },
      "primaryItemGroup": {
        "itemGroupId": "321196149534",
        "itemGroupType": "SELLER_DEFINED_VARIATIONS",
        "itemGroupHref": "https://api.api.ebay.com/buy/browse/v1/get_items_by_item_group?item_group_id=321196149534",
        "itemGroupTitle": " 3/4 Sleeve  Plain T-Shirt Lot Baseball  Raglan Jersey Sports Fashion Casual Tee",
        "itemGroupImage": {
          "imageUrl": "http://i.ebayimg.com/00/s/ .. QTsAAOSwIgNXwjY7/$_1.JPG?set_id=880000500F"
        },
        "itemGroupAdditionalImages": [
          {
            "imageUrl": "http://i.ebayimg.com/00/s/ .. Eh0AAOSwaB5XvIZM/$_1.JPG?set_id=880000500F"
          },
          {
            "imageUrl": "http://i.ebayimg.com/00/s/ ... gBSHpMizIOw~~60_1.JPG?set_id=880000500F"
          }
        ]
      }
    },
    {
      "itemId": "v1|321196149534|510153352421",
      "title": " 3/4 Sleeve  Plain T-Shirt Lot Baseball  Raglan Jersey Sports Fashion Casual Tee",
      "shortDescription": "Quantity : 1 pc Baseball ( Raglan ) T-Shirts. Double Stitched Neck & Arm Bottom Hem ...",
      "price": {
        "value": "5.99",
        "currency": "USD"
      },
      "categoryPath": "Clothing, Shoes & Accessories|Men's Clothing|Athletic Apparel",
      "condition": "New with tags",
      "itemLocation": {
        "city": "Los Angeles",
        "stateOrProvince": "California",
        "postalCode": "90019",
        "country": "US"
      },
      "image": {
        "imageUrl": "http://i.ebayimg.com/00/s/ ... 5eumEVBSHpu9W8E!~~60_1.JPG?set_id=880000500F"
      },
      "color": "Gray ( Heather ) / Black",
      "material": "100% Cotton",
      "sizeType": "Regular",
      "brand": "Youroutfitter90210",
      "itemEndDate": "2017-04-10T01:09:42.000Z",
      "seller": {
        "username": "yourcloset90210",
        "feedbackPercentage": "99.7",
        "feedbackScore": 69497
      },
      "estimatedAvailabilities": [
        {
          "deliveryOptions": [
            "SHIP_TO_HOME"
          ],
          "availabilityThresholdType": "MORE_THAN",
          "availabilityThreshold": 10,
          "estimatedAvailabilityStatus": "IN_STOCK",
          "estimatedSoldQuantity": 314
        }
      ],
      "shippingOptions": [
        {
          "shippingServiceCode": "Standard Shipping",
          "type": "Standard Shipping",
          "shippingCost": {
            "value": "2.99",
            "currency": "USD"
          },
          "quantityUsedForEstimate": 1,
          "minEstimatedDeliveryDate": "2017-04-03T10:00:00.000Z",
          "maxEstimatedDeliveryDate": "2017-04-03T10:00:00.000Z",
          "shipToLocationUsedForEstimate": {
            "postalCode": "19406",
            "country": "US"
          },
          "additionalShippingCostPerUnit": {
            "value": "1.99",
            "currency": "USD"
          },
          "shippingCostType": "FIXED"
        }
      ],
      "returnTerms": {
        "returnsAccepted": true,
        "refundMethod": "MONEY_BACK",
        "returnMethod": "EXCHANGE",
        "returnShippingCostPayer": "BUYER",
        "returnPeriod": {
          "value": 30,
          "unit": "CALENDAR_DAY"
        },
        "restockingFeePercentage": "20"
      },
      "localizedAspects": [
        {
          "type": "STRING",
          "name": "Size (Men's)",
          "value": "S"
        },
        {
          "type": "STRING",
          "name": "Color",
          "value": "Gray ( Heather ) / Black"
        },
        {
          "type": "STRING",
          "name": "Brand",
          "value": "Youroutfitter90210"
        },
        {
          "type": "STRING",
          "name": "Material",
          "value": "100% Cotton"
        },
        {
          "type": "STRING",
          "name": "Style",
          "value": "Shirts & Tops Raglan Baseball Jersey Tee"
        },
        {
          "type": "STRING",
          "name": "Sleeve Length",
          "value": "Short Sleeve"
        },
        {
          "type": "STRING",
          "name": "Size Type",
          "value": "Regular"
        },
        {
          "type": "STRING",
          "name": "Sleeve Length Detail",
          "value": "3/4 Sleeves"
        },
        {
          "type": "STRING",
          "name": "Sport",
          "value": "Gymnastics, Skateboarding, Auto Racing, Baseball & Softball, Bowling, Camping & Hiking, ..."
        }
      ],
      "buyingOptions": [
        "FIXED_PRICE"
      ],
      "itemAffiliateWebUrl": "http://rover.api.ebay.com/rover/1/711-53200-19255-0/1?campid=5337984774&customid=&toolid= ...",
      "itemWebUrl": "http://www.ebay.com/itm/3-4-Sleeve-Plain-T-Shirt-Lot-Baseball-Raglan-Jersey-Sports-Fashion-Casual-Tee ...",
      "shipToLocations": {
        "regionIncluded": [
          {
            "regionName": "Worldwide",
            "regionType": "WORLDWIDE"
          }
        ]
      },
      "primaryItemGroup": {
        "itemGroupId": "321196149534",
        "itemGroupType": "SELLER_DEFINED_VARIATIONS",
        "itemGroupHref": "https://api.api.ebay.com/buy/browse/v1/get_items_by_item_group?item_group_id=321196149534",
        "itemGroupTitle": " 3/4 Sleeve  Plain T-Shirt Lot Baseball  Raglan Jersey Sports Fashion Casual Tee",
        "itemGroupImage": {
          "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxNjAw/z/QTsAAOSwIgNXwjY7/$_1.JPG?set_id=880000500F"
        },
        "itemGroupAdditionalImages": [
          {
            "imageUrl": "http://i.ebayimg.com/00/s/MTYwMFgxNjAw/z/Eh0AAOSwaB5XvIZM/$_1.JPG?set_id=880000500F"
          },
          {
            "imageUrl": "http://i.ebayimg.com/00/s/MTAwMFgxMDAw/z/l0QAAMXQIrFSHpMj/$(KGrHqN,!mEFIG!DCc,gBSHpMizIOw~~60_1.JPG?set_id=880000500F"
          }
        ]
      }
    }
  ],
  "commonDescriptions": [
    {
      "description": "<font rwr=\"1\" size=\"4\"> ... Sleeves&nbsp;Baseball Raglan T Shirts&nbsp;/&nbsp;Fashion&nbsp;Vintage Tee ...",
      "itemIds": [
        "v1|321196149534|510153352420",
        "v1|321196149534|510153352421"
      ]
    }
  ]
}

 

 

Get Item call JSON response

url:
https://api.ebay.com/buy/browse/v1/item/v1|311784232826|0

{
  "itemId": "v1|311784232826|0",
  "title": "Sony PlayStation 4 Slim 500GB Console Uncharted 4 A Thief's End PS4 Game Bundle ",
  "shortDescription": "Sony PlayStation 4 Slim 500GB Console Uncharted 4 Bundle NEW. Uncharted 4: A Thief's End (physical disc). The new PlayStation 4 ...",
  "price": {
    "value": "234.99",
    "currency": "USD"
  },
  "categoryPath": "Video Games & Consoles|Video Game Consoles",
  "condition": "New",
  "itemLocation": {
    "city": "Various Locations",
    "country": "US"
  },
  "image": {
    "imageUrl": "http://i.ebayimg.com/00/s/MjQyWDUwMA==/ ... $_57.JPG?set_id=8800005007"
  },
  "additionalImages": [
    {
      "imageUrl": "http://i.ebayimg.com/00/s/NDg0WDUwMA==/ .. $_57.JPG?set_id=8800005007"
    },
    {
      "imageUrl": "http://i.ebayimg.com/00/s/Mjk3WDUwMA==/ .. $_57.JPG?set_id=8800005007"
    }
  ],
  "color": "Black",
  "brand": "Sony",
  "itemEndDate": "2017-04-20T14:51:29.000Z",
  "seller": {
    "username": "ordereasyas123",
    "feedbackPercentage": "99.8",
    "feedbackScore": 21051
  },
  "gtin": "711719503965",
  "estimatedAvailabilities": [
    {
      "deliveryOptions": [
        "SHIP_TO_HOME"
      ],
      "availabilityThresholdType": "MORE_THAN",
      "availabilityThreshold": 10,
      "estimatedAvailabilityStatus": "IN_STOCK",
      "estimatedSoldQuantity": 4024
    }
  ],
  "shippingOptions": [
    {
      "shippingServiceCode": "Economy Shipping",
      "type": "Economy Shipping",
      "shippingCost": {
        "value": "0.00",
        "currency": "USD"
      },
      "quantityUsedForEstimate": 1,
      "minEstimatedDeliveryDate": "2017-03-31T10:00:00.000Z",
      "maxEstimatedDeliveryDate": "2017-03-31T10:00:00.000Z",
      "shipToLocationUsedForEstimate": {
        "postalCode": "19406",
        "country": "US"
      },
      "additionalShippingCostPerUnit": {
        "value": "0.00",
        "currency": "USD"
      },
      "shippingCostType": "FIXED"
    },
    {
      "shippingServiceCode": "Expedited Shipping",
      "type": "Expedited Shipping",
      "shippingCost": {
        "value": "18.00",
        "currency": "USD"
      },
      "quantityUsedForEstimate": 1,
      "minEstimatedDeliveryDate": "2017-03-31T10:00:00.000Z",
      "maxEstimatedDeliveryDate": "2017-03-31T10:00:00.000Z",
      "shipToLocationUsedForEstimate": {
        "postalCode": "19406",
        "country": "US"
      },
      "additionalShippingCostPerUnit": {
        "value": "9.00",
        "currency": "USD"
      },
      "shippingCostType": "FIXED"
    }
  ],
  "returnTerms": {
    "returnsAccepted": true,
    "refundMethod": "MONEY_BACK",
    "returnMethod": "REPLACEMENT",
    "returnShippingCostPayer": "BUYER",
    "returnPeriod": {
      "value": 30,
      "unit": "CALENDAR_DAY"
    },
    "returnInstructions": "Returns maybe be subject to a restocking fee of up to 20% if the item  ...",
    "restockingFeePercentage": "20"
  },
  "localizedAspects": [
    {
      "type": "STRING",
      "name": "Type",
      "value": "Home Console"
    },
    {
      "type": "STRING",
      "name": "Model",
      "value": "PlayStation 4 Slim"
    },
    {
      "type": "STRING",
      "name": "Country/Region of Manufacture",
      "value": "China"
    },
    {
      "type": "STRING",
      "name": "Platform",
      "value": "Sony PlayStation 4"
    },
    {
      "type": "STRING",
      "name": "Color",
      "value": "Black"
    },
    {
      "type": "STRING",
      "name": "Hard Drive Capacity",
      "value": "500GB"
    },
    {
      "type": "STRING",
      "name": "Region Code",
      "value": "NTSC-U/C (US/Canda)"
    },
    {
      "type": "STRING",
      "name": "Brand",
      "value": "Sony"
    },
    {
      "type": "STRING",
      "name": "UPC",
      "value": "711719503965"
    }
  ],
  "description": "<font rwr='1' ... <font size=\"2\"> ... Brand new in original retail packaging. The new PlayStation 4 opens the door to ...",
  "quantityLimitPerBuyer": 5,
  "primaryProductReviewRating": {
    "reviewCount": 177,
    "averageRating": "4.85",
    "ratingHistograms": [
      {
        "rating": "5",
        "count": 387
      },
      {
        "rating": "4",
        "count": 28
      },
      {
        "rating": "3",
        "count": 1
      },
      {
        "rating": "2",
        "count": 3
      },
      {
        "rating": "1",
        "count": 6
      }
    ]
  },
  "buyingOptions": [
    "FIXED_PRICE"
  ],
  "itemAffiliateWebUrl": "http://rover.api.ebay.com/rover/1/711-53200-19255-0/1?campid=5337984774&customid=&toolid=...",
  "itemWebUrl": "http://www.api.ebay.com/itm/Sony-PlayStation-4-Slim-500GB-Console-Uncharted-4-A-Thiefs-End-PS4-Game-Bundle ...",
  "shipToLocations": {
    "regionIncluded": [
      {
        "regionName": "United States",
        "regionType": "COUNTRY"
      }
    ],
    "regionExcluded": [
      {
        "regionName": "Alaska/Hawaii",
        "regionType": "COUNTRY_REGION"
      },
      {
        "regionName": "US Protectorates",
        "regionType": "COUNTRY_REGION"
      },
      {
        "regionName": "APO/FPO",
        "regionType": "COUNTRY_REGION"
      },
      {
        "regionName": "PO Box",
        "regionType": "COUNTRY_REGION"
      }
    ]
  }
}

 

 

Get Item calls response

All the Get Item, Get Item by Legacy Id, and Get Item by Item Group call return the same fields. The Get Item and Get Item by Legacy Id call return the item details of one item. The Get Item by Item Group calls returns all the items in an item group.

Because the Get Item by Item Group call returns multiple items, the details are returns in an array of items containers. The Get Item by Item Group call also returns an array of commonDescriptions containers. These containers have the item description and the item Ids of all the items that have this exact description. This makes the response smaller because instead of repeating this description in the item details of each item, any description that is shared by at least one other item is returned in this container along with the item Ids that use this description.

The following table shows the response fields for Get Item, Get Item by Legacy Id calls, which are the same, and the Get Item by Item Group call. The differences between the responses is highlighted in bold.

Get Item call response
Get Item by Legacy Id call response		 Get Item by Item Group call response
  commonDescriptions (array)
  commonDescriptions.description
  commonDescriptions.itemIds
  items (array)
additionalImages items.additionalImages
additionalImages.height items.additionalImages.height
additionalImages.imageUrl items.additionalImages.imageUrl
additionalImages.width items.additionalImages.width
ageGroup items.ageGroup
bidCount items.bidCount
brand items.brand
buyingOptions items.buyingOptions
categoryPath items.categoryPath
color items.color
condition items.condition
currentBidPrice items.currentBidPrice
currentBidPrice.convertedFromCurrency items.currentBidPrice.convertedFromCurrency
currentBidPrice.convertedFromValue items.currentBidPrice.convertedFromValue
currentBidPrice.currency items.currentBidPrice.currency
currentBidPrice.value items.currentBidPrice.value
description items.description
energyEfficiencyClass items.energyEfficiencyClass
estimatedAvailabilities items.estimatedAvailabilities
estimatedAvailabilities.availabilityThreshold items.estimatedAvailabilities.availabilityThreshold
estimatedAvailabilities.availabilityThresholdType items.estimatedAvailabilities.availabilityThresholdType
estimatedAvailabilities.deliveryOptions items.estimatedAvailabilities.deliveryOptions
estimatedAvailabilities.estimatedAvailabilityStatus items.estimatedAvailabilities.estimatedAvailabilityStatus
estimatedAvailabilities.estimatedAvailableQuantity items.estimatedAvailabilities.estimatedAvailableQuantity
estimatedAvailabilities.estimatedSoldQuantity items.estimatedAvailabilities.estimatedSoldQuantity
gender items.gender
gtin items.gtin
image items.image
image.height items.image.height
image.imageUrl items.image.imageUrl
image.width items.image.width
itemAffiliateWebUrl items.itemAffiliateWebUrl
itemEndDate items.itemEndDate
itemId items.itemId
itemLocation items.itemLocation
itemLocation.addressLine1 items.itemLocation.addressLine1
itemLocation.addressLine2 items.itemLocation.addressLine2
itemLocation.city items.itemLocation.city
itemLocation.country items.itemLocation.country
itemLocation.county items.itemLocation.county
itemLocation.postalCode items.itemLocation.postalCode
itemLocation.stateOrProvince items.itemLocation.stateOrProvince
itemWebUrl items.itemWebUrl
localizedAspects items.localizedAspects
localizedAspects.name items.localizedAspects.name
localizedAspects.type items.localizedAspects.type
localizedAspects.value items.localizedAspects.value
marketingPrice items.marketingPrice
marketingPrice.discountAmount items.marketingPrice.discountAmount
marketingPrice.discountAmount.convertedFromCurrency items.marketingPrice.discountAmount.convertedFromCurrency
marketingPrice.discountAmount.convertedFromValue items.marketingPrice.discountAmount.convertedFromValue
marketingPrice.discountAmount.currency items.marketingPrice.discountAmount.currency
marketingPrice.discountAmount.value items.marketingPrice.discountAmount.value
marketingPrice.discountPercentage items.marketingPrice.discountPercentage
marketingPrice.originalPrice items.marketingPrice.originalPrice
marketingPrice.originalPrice.convertedFromCurrency items.marketingPrice.originalPrice.convertedFromCurrency
marketingPrice.originalPrice.convertedFromValue items.marketingPrice.originalPrice.convertedFromValue
marketingPrice.originalPrice.currency items.marketingPrice.originalPrice.currency
marketingPrice.originalPrice.value items.marketingPrice.originalPrice.value
material items.material
mpn items.mpn
pattern items.pattern
price items.price
price.convertedFromCurrency items.price.convertedFromCurrency
price.convertedFromValue items.price.convertedFromValue
price.currency items.price.currency
price.value items.price.value
priceDisplayCondition items.priceDisplayCondition
primaryItemGroup items.primaryItemGroup
primaryItemGroup.itemGroupAdditionalImages items.primaryItemGroup.itemGroupAdditionalImages
primaryItemGroup.itemGroupAdditionalImages.height items.primaryItemGroup.itemGroupAdditionalImages.height
primaryItemGroup.itemGroupAdditionalImages.imageUrl items.primaryItemGroup.itemGroupAdditionalImages.imageUrl
primaryItemGroup.itemGroupAdditionalImages.width items.primaryItemGroup.itemGroupAdditionalImages.width
primaryItemGroup.itemGroupHref items.primaryItemGroup.itemGroupHref
primaryItemGroup.itemGroupId items.primaryItemGroup.itemGroupId
primaryItemGroup.itemGroupImage items.primaryItemGroup.itemGroupImage
primaryItemGroup.itemGroupImage.height items.primaryItemGroup.itemGroupImage.height
primaryItemGroup.itemGroupImage.imageUrl items.primaryItemGroup.itemGroupImage.imageUrl
primaryItemGroup.itemGroupImage.width items.primaryItemGroup.itemGroupImage.width
primaryItemGroup.itemGroupTitle items.primaryItemGroup.itemGroupTitle
primaryItemGroup.itemGroupType items.primaryItemGroup.itemGroupType
primaryProductReviewRating items.primaryProductReviewRating
primaryProductReviewRating.averageRating items.primaryProductReviewRating.averageRating
primaryProductReviewRating.ratingHistograms items.primaryProductReviewRating.ratingHistograms
primaryProductReviewRating.ratingHistograms.count items.primaryProductReviewRating.ratingHistograms.count
primaryProductReviewRating.ratingHistograms.rating items.primaryProductReviewRating.ratingHistograms.rating
primaryProductReviewRating.reviewCount items.primaryProductReviewRating.reviewCount
quantityLimitPerBuyer items.quantityLimitPerBuyer
returnTerms items.returnTerms
returnTerms.extendedHolidayReturnsOffered. items.returnTerms.extendedHolidayReturnsOffered.
returnTerms.refundMethod items.returnTerms.refundMethod
returnTerms.restockingFeePercentage items.returnTerms.restockingFeePercentage
returnTerms.returnInstructions items.returnTerms.returnInstructions
returnTerms.returnMethod items.returnTerms.returnMethod
returnTerms.returnPeriod items.returnTerms.returnPeriod
returnTerms.returnPeriod.unit items.returnTerms.returnPeriod.unit
returnTerms.returnPeriod.value items.returnTerms.returnPeriod.value
returnTerms.returnsAccepted items.returnTerms.returnsAccepted
returnTerms.returnShippingCostPayer items.returnTerms.returnShippingCostPayer
seller items.seller
seller.feedbackPercentage items.seller.feedbackPercentage
seller.feedbackScore items.seller.feedbackScore
seller.sellerAccountType items.seller.sellerAccountType
seller.username items.seller.username
shippingOptions items.shippingOptions
shippingOptions.additionalShippingCostPerUnit items.shippingOptions.additionalShippingCostPerUnit
shippingOptions.additionalShippingCostPerUnit.convertedFromCurrency items.shippingOptions.additionalShippingCostPerUnit.convertedFromCurrency
shippingOptions.additionalShippingCostPerUnit.convertedFromValue items.shippingOptions.additionalShippingCostPerUnit.convertedFromValue
shippingOptions.additionalShippingCostPerUnit.currency items.shippingOptions.additionalShippingCostPerUnit.currency
shippingOptions.additionalShippingCostPerUnit.value items.shippingOptions.additionalShippingCostPerUnit.value
shippingOptions.cutOffDateUsedForEstimate items.shippingOptions.cutOffDateUsedForEstimate
shippingOptions.maxEstimatedDeliveryDate items.shippingOptions.maxEstimatedDeliveryDate
shippingOptions.minEstimatedDeliveryDate items.shippingOptions.minEstimatedDeliveryDate
shippingOptions.quantityUsedForEstimate items.shippingOptions.quantityUsedForEstimate
shippingOptions.shippingCarrierCode items.shippingOptions.shippingCarrierCode
shippingOptions.shippingCost items.shippingOptions.shippingCost
shippingOptions.shippingCost.convertedFromCurrency items.shippingOptions.shippingCost.convertedFromCurrency
shippingOptions.shippingCost.convertedFromValue items.shippingOptions.shippingCost.convertedFromValue
shippingOptions.shippingCost.currency items.shippingOptions.shippingCost.currency
shippingOptions.shippingCost.value items.shippingOptions.shippingCost.value
shippingOptions.shippingCostType items.shippingOptions.shippingCostType
shippingOptions.shippingServiceCode items.shippingOptions.shippingServiceCode
shippingOptions.shipToLocationUsedForEstimate items.shippingOptions.shipToLocationUsedForEstimate
shippingOptions.shipToLocationUsedForEstimate.country items.shippingOptions.shipToLocationUsedForEstimate.country
shippingOptions.shipToLocationUsedForEstimate.postalCode items.shippingOptions.shipToLocationUsedForEstimate.postalCode
shippingOptions.trademarkSymbol items.shippingOptions.trademarkSymbol
shippingOptions.type items.shippingOptions.type
shipToLocations items.shipToLocations
shipToLocations.regionExcluded items.shipToLocations.regionExcluded
shipToLocations.regionExcluded.regionName items.shipToLocations.regionExcluded.regionName
shipToLocations.regionExcluded.regionType items.shipToLocations.regionExcluded.regionType
shipToLocations.regionIncluded items.shipToLocations.regionIncluded
shipToLocations.regionIncluded.regionName items.shipToLocations.regionIncluded.regionName
shipToLocations.regionIncluded.regionType items.shipToLocations.regionIncluded.regionType
shortDescription items.shortDescription
size items.size
sizeSystem items.sizeSystem
sizeType items.sizeType
subtitle items.subtitle
title items.title
topRatedBuyingExperience items.topRatedBuyingExperience
uniqueBidderCount items.uniqueBidderCount