---
title: "Taobao and Tmall Product Details API (V1)"
description: "Retrieves Taobao or Tmall product details by item ID through the V1 endpoint. Use it to perform direct product lookup for catalog research, product monitoring, or ecommerce analysis."
aiUsagePrompt: true
---

# Taobao and Tmall Product Details API \(V1\)

<ApiTester
  method="GET"
  :path='JSON.parse("\"/api/taobao/get-item-detail/v1\"")'
  :summary='JSON.parse("\"Product Details (V1)\"")'
  openapiDefinitionUrl="https://docs.justoneapi.com/openapi/taobao-and-tmall/product-details-v1-en.json"
  openapiVersion="3.1.0"
  :parameters='JSON.parse("[{\"name\":\"token\",\"in\":\"query\",\"description\":\"Access token for this API service.\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"itemId\",\"in\":\"query\",\"description\":\"Unique product identifier on Taobao/Tmall (item ID).\",\"required\":true,\"schema\":{\"type\":\"string\"}}]")'
  :requestBody='JSON.parse("null")'
  :responses='JSON.parse("{\"200\":{\"description\":\"OK\",\"content\":{\"application/json\":{\"schema\":{\"if\":{\"properties\":{\"code\":{\"const\":0}},\"required\":[\"code\"]},\"then\":{\"properties\":{\"data\":{\"type\":\"object\",\"description\":\"Taobao or Tmall product detail with listing information, prices, specifications, and related content as available.\",\"properties\":{\"item\":{\"type\":\"object\",\"description\":\"Product information for the requested item.\",\"properties\":{\"itemId\":{\"type\":\"integer\",\"description\":\"Taobao or Tmall item ID, returned as an integer.\"},\"title\":{\"type\":\"string\",\"description\":\"Display title of the listing.\"},\"categoryId\":{\"type\":\"string\",\"description\":\"Category ID assigned to the item, returned as text.\"},\"rootCategoryId\":{\"type\":\"string\",\"description\":\"Top-level category ID assigned to the item, returned as text.\"},\"location\":{\"type\":\"string\",\"description\":\"Location displayed for the item.\"},\"sellCount\":{\"type\":\"string\",\"description\":\"Sales count text displayed for the item.\"},\"seoItemType\":{\"type\":\"string\",\"description\":\"Platform listing type label returned for the item.\"},\"images\":{\"type\":\"array\",\"description\":\"Product image URLs in the order returned.\",\"items\":{\"type\":\"string\",\"description\":\"URL of a product image.\"}},\"videos\":{\"type\":\"array\",\"description\":\"Videos returned with the listing.\",\"items\":{\"type\":\"object\",\"description\":\"One product video.\",\"properties\":{\"videoUrl\":{\"type\":\"string\",\"description\":\"URL for the product video.\"},\"coverUrl\":{\"type\":\"string\",\"description\":\"Cover image URL for the product video.\"},\"uploadDate\":{\"type\":\"string\",\"description\":\"Upload date text reported for the product video.\"}}}},\"kolVideos\":{\"type\":\"array\",\"description\":\"Creator videos associated with the listing, when returned.\",\"items\":{\"type\":\"object\",\"description\":\"One video from a creator associated with the listing.\",\"properties\":{\"nick\":{\"type\":\"string\",\"description\":\"Display nickname of the creator.\"},\"coverUrl\":{\"type\":\"string\",\"description\":\"Cover image URL for the creator video.\"},\"video5sUrl\":{\"type\":\"string\",\"description\":\"URL provided for the short video preview.\"},\"videoUrl\":{\"type\":\"string\",\"description\":\"URL for the creator video.\"}}}},\"beehiveContent\":{\"type\":\"object\",\"description\":\"Related content shown with the product.\",\"properties\":{\"accountName\":{\"type\":\"string\",\"description\":\"Display name of the related content account.\"},\"contentAggreName\":{\"type\":\"string\",\"description\":\"Display name of the related content collection.\"},\"contentAggreUrl\":{\"type\":\"string\",\"description\":\"Link to the related content collection, when available.\"},\"contentCover\":{\"type\":\"string\",\"description\":\"Cover image URL for the related content.\"},\"contentDetailUrl\":{\"type\":\"string\",\"description\":\"Link to the related content details.\"},\"contentSummary\":{\"type\":\"string\",\"description\":\"Summary text for the related content.\"},\"contentTitle\":{\"type\":\"string\",\"description\":\"Display title of the related content.\"}}}}},\"itemDesc\":{\"type\":\"string\",\"description\":\"Product description as HTML text. Description image links can appear inside the markup.\"},\"itemExist\":{\"type\":\"boolean\",\"description\":\"Item existence flag reported in the product detail.\"},\"success\":{\"type\":\"boolean\",\"description\":\"Success flag reported inside the product detail data.\"},\"areaLimit\":{\"type\":\"boolean\",\"description\":\"Whether a regional restriction is reported for the item.\"},\"freeShipping\":{\"type\":\"boolean\",\"description\":\"Whether the item is marked as offering free shipping.\"},\"skuId\":{\"type\":\"integer\",\"description\":\"SKU ID returned alongside the product information.\"},\"creativeText\":{\"type\":\"string\",\"description\":\"Promotional display text associated with the item, when available.\"},\"itemPrice\":{\"type\":\"object\",\"description\":\"Item-level pricing and promotion display information.\",\"properties\":{\"price\":{\"type\":\"string\",\"description\":\"Item price text returned for the listing, when available.\"},\"originalPrice\":{\"type\":\"string\",\"description\":\"Reported original item price as text.\"},\"promotionPrice\":{\"type\":\"string\",\"description\":\"Reported item promotional price as text.\"},\"promotionName\":{\"type\":\"string\",\"description\":\"Display name of the item promotion.\"},\"hasRangePrice\":{\"type\":\"boolean\",\"description\":\"Whether the price information is marked as a range.\"},\"exchangePriceHKD\":{\"type\":\"string\",\"description\":\"Displayed price converted to Hong Kong dollars.\"},\"exchangePriceTWD\":{\"type\":\"string\",\"description\":\"Displayed price converted to New Taiwan dollars.\"},\"startTime\":{\"type\":\"string\",\"description\":\"Reported start time text for the price information.\"},\"endTime\":{\"type\":\"string\",\"description\":\"Reported end time text for the price information.\"},\"remark\":{\"type\":\"string\",\"description\":\"Display note provided with the price information.\"}}},\"coupon\":{\"type\":\"object\",\"description\":\"Coupon information returned for the item.\",\"properties\":{\"coupon\":{\"type\":\"object\",\"description\":\"Coupon details embedded in the response.\",\"properties\":{\"couponClickUrl\":{\"type\":\"string\",\"description\":\"Link provided for the coupon, when available.\"},\"couponInfo\":{\"type\":\"string\",\"description\":\"Displayed coupon description.\"},\"couponPrice\":{\"type\":\"integer\",\"description\":\"Reported coupon amount as an integer value.\"},\"couponStartTime\":{\"type\":\"string\",\"description\":\"Reported start time text for the coupon.\"},\"couponEndTime\":{\"type\":\"string\",\"description\":\"Reported end time text for the coupon.\"},\"couponRemainCount\":{\"type\":\"integer\",\"description\":\"Reported number of coupons remaining.\"},\"couponTotalCount\":{\"type\":\"integer\",\"description\":\"Reported total number of coupons.\"},\"itemUrl\":{\"type\":\"string\",\"description\":\"Item listing link provided with the coupon information.\"}}}}},\"itemSkuDO\":{\"type\":\"object\",\"description\":\"SKU details, specification combinations, and selectable options.\",\"properties\":{\"skuList\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\",\"description\":\"Details of the SKU identified by the map key.\",\"properties\":{\"skuId\":{\"type\":\"integer\",\"description\":\"SKU ID, returned as an integer.\"},\"propPath\":{\"type\":\"string\",\"description\":\"SKU specification path. Each pair joins a property ID and value ID with a colon, and multiple pairs are separated by semicolons.\"},\"quantity\":{\"type\":\"string\",\"description\":\"Reported quantity for this SKU, returned as text.\"},\"price\":{\"type\":\"string\",\"description\":\"Reported price text for this SKU, when available.\"},\"priceMoney\":{\"type\":\"integer\",\"description\":\"Reported integer representation of this SKU price, when available.\"}}},\"description\":\"SKU map whose keys are SKU IDs represented as strings. Pricing fields can be absent for some items.\"},\"skuPVPairList\":{\"type\":\"array\",\"description\":\"List of SKU IDs and their specification paths.\",\"items\":{\"type\":\"object\",\"description\":\"One SKU and its selected specification combination.\",\"properties\":{\"skuId\":{\"type\":\"integer\",\"description\":\"SKU ID, returned as an integer.\"},\"propPath\":{\"type\":\"string\",\"description\":\"SKU specification path. Each pair joins a property ID and value ID with a colon, and multiple pairs are separated by semicolons.\"}}}},\"skuPropertyList\":{\"type\":\"array\",\"description\":\"Specification properties that define the item variants.\",\"items\":{\"type\":\"object\",\"description\":\"One specification property and its options.\",\"properties\":{\"pid\":{\"type\":\"integer\",\"description\":\"Specification property ID, returned as an integer.\"},\"name\":{\"type\":\"string\",\"description\":\"Display name of the specification property.\"},\"propertyValues\":{\"type\":\"array\",\"description\":\"Selectable values for the specification property.\",\"items\":{\"type\":\"object\",\"description\":\"One option value for the specification property.\",\"properties\":{\"vid\":{\"type\":\"integer\",\"description\":\"Option value ID, returned as an integer.\"},\"name\":{\"type\":\"string\",\"description\":\"Display name of the option value.\"},\"image\":{\"type\":\"string\",\"description\":\"Image URL for the option value, when available.\"}}}}}}}}},\"props\":{\"type\":\"object\",\"description\":\"Grouped product attributes displayed for the item.\",\"properties\":{\"groupProps\":{\"type\":\"array\",\"description\":\"Attribute groups with platform-provided group and attribute names.\",\"items\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"array\",\"description\":\"List of attributes for the group identified by the map key.\",\"items\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"string\",\"description\":\"Displayed text value of the attribute named by the key.\"},\"description\":\"An object keyed by the displayed attribute name.\"}},\"description\":\"An object keyed by attribute group name.\"}}}},\"seller\":{\"type\":\"object\",\"description\":\"Shop and seller information returned with the item.\",\"properties\":{\"shopId\":{\"type\":\"integer\",\"description\":\"Marketplace shop ID, returned as an integer.\"},\"userId\":{\"type\":\"integer\",\"description\":\"Marketplace account ID of the seller, returned as an integer.\"},\"shopName\":{\"type\":\"string\",\"description\":\"Shop display name.\"},\"shopIcon\":{\"type\":\"string\",\"description\":\"Shop icon image URL.\"},\"shopUrl\":{\"type\":\"string\",\"description\":\"Link to the shop page.\"},\"taoShopUrl\":{\"type\":\"string\",\"description\":\"Another shop link returned for this listing.\"},\"sellerType\":{\"type\":\"string\",\"description\":\"Seller type code reported by the marketplace.\"},\"creditLevel\":{\"type\":\"string\",\"description\":\"Seller credit level reported as text.\"},\"allItemCount\":{\"type\":\"integer\",\"description\":\"Reported count of items in the shop.\"},\"newItemCount\":{\"type\":\"integer\",\"description\":\"Reported count of new items in the shop.\"},\"showShopLinkIcon\":{\"type\":\"boolean\",\"description\":\"Whether the presentation metadata indicates that the shop link icon is shown.\"},\"evaluates\":{\"type\":\"array\",\"description\":\"Ratings reported by the marketplace for the shop.\",\"items\":{\"type\":\"object\",\"description\":\"One reported shop rating.\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"Display title of the shop rating criterion.\"},\"score\":{\"type\":\"string\",\"description\":\"Reported score for the specified criterion, returned as text.\"},\"level\":{\"type\":\"string\",\"description\":\"Reported level code for the score.\"},\"type\":{\"type\":\"string\",\"description\":\"Reported rating criterion type code.\"}}}}}},\"itemTrade\":{\"type\":\"object\",\"description\":\"Sales and payment information returned with the item.\",\"properties\":{\"soldQuantityTotal\":{\"type\":\"string\",\"description\":\"Reported total quantity sold, returned as display text.\"},\"paymentList\":{\"type\":\"array\",\"description\":\"Payment options displayed with the product.\",\"items\":{\"type\":\"object\",\"description\":\"One displayed payment option.\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"Display name of the payment option.\"},\"logo\":{\"type\":\"string\",\"description\":\"Logo image URL for the payment option.\"}}}}}},\"merchantReturnRegion\":{\"type\":\"array\",\"description\":\"Regions listed for merchant returns.\",\"items\":{\"type\":\"string\",\"description\":\"A region listed for merchant returns.\"}},\"service\":{\"type\":\"object\",\"description\":\"Merchant service information associated with the item.\",\"properties\":{\"remarkUrl\":{\"type\":\"string\",\"description\":\"Link provided for the service details.\"}}},\"rate\":{\"type\":\"object\",\"description\":\"Review breakdown and selected reviews in the product detail.\",\"properties\":{\"totalCount\":{\"type\":\"string\",\"description\":\"Reported total number of reviews, returned as text.\"},\"hasAppendCount\":{\"type\":\"string\",\"description\":\"Reported count of reviews with follow-up content, returned as text.\"},\"hasMediaCount\":{\"type\":\"string\",\"description\":\"Reported count of reviews with media, returned as text.\"},\"hasNextPage\":{\"type\":\"boolean\",\"description\":\"Whether the review preview indicates that more reviews are available.\"},\"keywords\":{\"type\":\"array\",\"description\":\"Review keywords and their reported counts.\",\"items\":{\"type\":\"object\",\"description\":\"One review keyword displayed for the product.\",\"properties\":{\"word\":{\"type\":\"string\",\"description\":\"Display text of the review keyword.\"},\"count\":{\"type\":\"integer\",\"description\":\"Reported count for the review keyword.\"},\"labelId\":{\"type\":\"string\",\"description\":\"Review keyword label ID, returned as text.\"},\"type\":{\"type\":\"integer\",\"description\":\"Reported type code of the review keyword.\"}}}},\"rateList\":{\"type\":\"array\",\"description\":\"Reviews included with the item details.\",\"items\":{\"type\":\"object\",\"description\":\"One review returned for the item.\",\"properties\":{\"userName\":{\"type\":\"string\",\"description\":\"Displayed name of the reviewer.\"},\"headPic\":{\"type\":\"string\",\"description\":\"Image URL for the reviewer’s displayed avatar.\"},\"content\":{\"type\":\"string\",\"description\":\"Text content of the review.\"},\"dateTime\":{\"type\":\"string\",\"description\":\"Reported publication time text for the review.\"},\"skuInfo\":{\"type\":\"string\",\"description\":\"Displayed SKU information associated with the review.\"},\"commentScore\":{\"type\":\"string\",\"description\":\"Reported review score as text.\"},\"likeCount\":{\"type\":\"integer\",\"description\":\"Reported number of likes on the review.\"},\"images\":{\"type\":\"array\",\"description\":\"Image URLs attached to the review, when available.\",\"items\":{\"type\":\"string\",\"description\":\"URL of an image attached to the review.\"}},\"appendRateList\":{\"type\":\"array\",\"description\":\"Follow-up content for the review, when returned.\",\"items\":{\"type\":\"object\",\"description\":\"One follow-up entry for the review.\",\"properties\":{\"content\":{\"type\":\"string\",\"description\":\"Text content of the follow-up review.\"},\"appendIntervalDay\":{\"type\":\"string\",\"description\":\"Reported interval in days before the follow-up, returned as text.\"},\"images\":{\"type\":\"array\",\"description\":\"Image URLs attached to the follow-up review, when available.\",\"items\":{\"type\":\"string\",\"description\":\"URL of an image attached to the follow-up review.\"}}}}}}}}}},\"itemAskDOList\":{\"type\":\"array\",\"description\":\"Product questions and included answers, when available.\",\"items\":{\"type\":\"object\",\"description\":\"One question associated with the product.\",\"properties\":{\"askContent\":{\"type\":\"string\",\"description\":\"Text of the question.\"},\"askUserNick\":{\"type\":\"string\",\"description\":\"Displayed nickname of the person who asked the question.\"},\"createTime\":{\"type\":\"string\",\"description\":\"Reported creation time text for the question.\"},\"answerList\":{\"type\":\"array\",\"description\":\"Answers included with the question.\",\"items\":{\"type\":\"object\",\"description\":\"One answer to the product question.\",\"properties\":{\"answerContent\":{\"type\":\"string\",\"description\":\"Text of the answer.\"},\"createTime\":{\"type\":\"string\",\"description\":\"Reported creation time text for the answer.\"},\"userNick\":{\"type\":\"string\",\"description\":\"Displayed nickname of the person who answered.\"}}}}}}},\"mainItemInfo\":{\"type\":\"object\",\"description\":\"Display information for the main listing.\",\"properties\":{\"itemId\":{\"type\":\"string\",\"description\":\"Item ID as text in the listing summary.\"},\"itemName\":{\"type\":\"string\",\"description\":\"Display name in the listing summary.\"},\"pic\":{\"type\":\"string\",\"description\":\"Product image URL in the listing summary.\"},\"url\":{\"type\":\"string\",\"description\":\"Product link in the listing summary, when provided.\"},\"afterCouponAmountPrice\":{\"type\":\"string\",\"description\":\"Displayed after-coupon price text in the listing summary.\"},\"zkFinalPrice\":{\"type\":\"string\",\"description\":\"Displayed final discounted price in the listing summary, when provided.\"},\"promotionModel\":{\"type\":\"object\",\"description\":\"Promotion presentation details, when returned.\",\"properties\":{\"promotionPriceModel\":{\"type\":\"object\",\"description\":\"Reported amounts and display text for the promotion.\",\"properties\":{\"promotionPrice\":{\"type\":\"string\",\"description\":\"Reported amount of the promotional price, returned as text.\"},\"promotionPriceDescDisplay\":{\"type\":\"string\",\"description\":\"Displayed description for the promotional price.\"},\"promotionPriceDisplay\":{\"type\":\"string\",\"description\":\"Displayed text for the promotional price.\"},\"zkPrice\":{\"type\":\"string\",\"description\":\"Reported discounted price amount, returned as text.\"},\"zkPriceDisplay\":{\"type\":\"string\",\"description\":\"Displayed text for the discounted price.\"}}},\"promotionTagModel\":{\"type\":\"array\",\"description\":\"Labels used to display the promotion.\",\"items\":{\"type\":\"object\",\"description\":\"One promotion display label.\",\"properties\":{\"tagDisplay\":{\"type\":\"string\",\"description\":\"Displayed promotion label text.\"},\"tagType\":{\"type\":\"string\",\"description\":\"Reported type code for the promotion label.\"},\"tagTypeDisplay\":{\"type\":\"string\",\"description\":\"Displayed name of the promotion label type.\"}}}}}},\"taobaoPromotionModel\":{\"type\":\"object\",\"description\":\"Marketplace promotion summary, when available.\",\"properties\":{\"finalPromotionInfo\":{\"type\":\"object\",\"description\":\"Final promotional price information returned in the summary.\",\"properties\":{\"finalPromotionPrice\":{\"type\":\"string\",\"description\":\"Reported final promotional price as text.\"}}}}}}}}}}},\"allOf\":[{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}]}}}},\"400\":{\"description\":\"Invalid request parameters or body\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"401\":{\"description\":\"Invalid or inactive access token\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"403\":{\"description\":\"Permission denied\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"429\":{\"description\":\"Request rate or daily quota limit exceeded\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"503\":{\"description\":\"Service temporarily unavailable\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}}}")'
  :servers='JSON.parse("[{\"url\":\"https://api.justoneapi.com\",\"description\":\"Global production API (default)\"}]")'
  :security='JSON.parse("[]")'
  :securitySchemes='JSON.parse("{}")'
  :schemas='JSON.parse("{}")'
/>

<ApiHealthSection :api='JSON.parse("\"/api/taobao/get-item-detail/v1\"")' />

<p>Retrieves Taobao or Tmall product details by item ID through the V1 endpoint. Use it to perform direct product lookup for catalog research, product monitoring, or ecommerce analysis.</p>

## Highlights

::: warning Condition · Price
<p>Returns the original product price. SKU prices are available for some products and may be absent for others.</p>
:::

::: info Capability · Attributes
<p>Provides a grouped product-parameter table.</p>
:::

::: info Capability · SKU options
<p>Provides SKU identifiers, specification options and quantity information.</p>
:::

::: info Capability · Main and carousel images
<p>Provides product main and carousel images.</p>
:::

::: warning Condition · Description images
<p>Description images are included in description HTML and need to be extracted; a separate image list is not provided.</p>
:::

::: tip Condition
<p>Some products may not be available through this endpoint.</p>
:::

## Parameters

<div class="api-doc-table api-doc-table--params">

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| <code>token</code> | query | <code>string</code> | Yes | - | Access token for this API service. |
| <code>itemId</code> | query | <code>string</code> | Yes | - | Unique product identifier on Taobao/Tmall (item ID). |

</div>

## Code Samples

::: code-group

```bash [🐚 cURL]
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE'
```

```text [🤖 AI Prompt]
I want to use the "Product Details (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE
API Endpoint: BASE_URL + /api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/taobao-and-tmall/product-details-v1-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- itemId (query): Unique product identifier on Taobao/Tmall (item ID). (Required)

Return format: safely handle JSON or text according to the actual Content-Type.

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance
   - 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.

Please help me write a script in my preferred programming language to call this API and handle the response.
```

```python [🐍 Python]
import requests

BASE_URL = "https://api.justoneapi.com"  # Provided by OpenAPI servers

url = BASE_URL + "/api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
```

```js [🌐 JavaScript]
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
```

```java [☕ Java]
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
        final String url = BASE_URL + "/api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
```

```go [🐹 Go]
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
```

```php [🐘 PHP]
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/taobao/get-item-detail/v1?token=YOUR_API_KEY&itemId=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}
```

:::

<div style="text-align: right; margin-top: -20px; margin-bottom: 20px;">
<a href="/openapi/taobao-and-tmall/product-details-v1-en.json" target="_blank" style="font-size: 12px; color: var(--vp-c-text-3); text-decoration: none; opacity: 0.8;">[OpenAPI Definition (JSON)]</a>
</div>

## Response Fields

Key fields in a successful response (`code = 0`).

<div class="api-doc-table api-doc-table--response">

| Field path | Type | Description |
| --- | --- | --- |
| <code>data</code> | <code>object</code> | Taobao or Tmall product detail with listing information, prices, specifications, and related content as available. |
| <code>data.item</code> | <code>object</code> | Product information for the requested item. |
| <code>data.item.itemId</code> | <code>integer</code> | Taobao or Tmall item ID, returned as an integer. |
| <code>data.item.title</code> | <code>string</code> | Display title of the listing. |
| <code>data.item.categoryId</code> | <code>string</code> | Category ID assigned to the item, returned as text. |
| <code>data.item.rootCategoryId</code> | <code>string</code> | Top-level category ID assigned to the item, returned as text. |
| <code>data.item.location</code> | <code>string</code> | Location displayed for the item. |
| <code>data.item.sellCount</code> | <code>string</code> | Sales count text displayed for the item. |
| <code>data.item.seoItemType</code> | <code>string</code> | Platform listing type label returned for the item. |
| <code>data.item.images</code> | <code>array</code> | Product image URLs in the order returned. |
| <code>data.item.images[]</code> | <code>string</code> | URL of a product image. |
| <code>data.item.videos</code> | <code>array</code> | Videos returned with the listing. |
| <code>data.item.videos[]</code> | <code>object</code> | One product video. |
| <code>data.item.videos[].videoUrl</code> | <code>string</code> | URL for the product video. |
| <code>data.item.videos[].coverUrl</code> | <code>string</code> | Cover image URL for the product video. |
| <code>data.item.videos[].uploadDate</code> | <code>string</code> | Upload date text reported for the product video. |
| <code>data.item.kolVideos</code> | <code>array</code> | Creator videos associated with the listing, when returned. |
| <code>data.item.kolVideos[]</code> | <code>object</code> | One video from a creator associated with the listing. |
| <code>data.item.kolVideos[].nick</code> | <code>string</code> | Display nickname of the creator. |
| <code>data.item.kolVideos[].coverUrl</code> | <code>string</code> | Cover image URL for the creator video. |
| <code>data.item.kolVideos[].video5sUrl</code> | <code>string</code> | URL provided for the short video preview. |
| <code>data.item.kolVideos[].videoUrl</code> | <code>string</code> | URL for the creator video. |
| <code>data.item.beehiveContent</code> | <code>object</code> | Related content shown with the product. |
| <code>data.item.beehiveContent.accountName</code> | <code>string</code> | Display name of the related content account. |
| <code>data.item.beehiveContent.contentAggreName</code> | <code>string</code> | Display name of the related content collection. |
| <code>data.item.beehiveContent.contentAggreUrl</code> | <code>string</code> | Link to the related content collection, when available. |
| <code>data.item.beehiveContent.contentCover</code> | <code>string</code> | Cover image URL for the related content. |
| <code>data.item.beehiveContent.contentDetailUrl</code> | <code>string</code> | Link to the related content details. |
| <code>data.item.beehiveContent.contentSummary</code> | <code>string</code> | Summary text for the related content. |
| <code>data.item.beehiveContent.contentTitle</code> | <code>string</code> | Display title of the related content. |
| <code>data.itemDesc</code> | <code>string</code> | Product description as HTML text. Description image links can appear inside the markup. |
| <code>data.itemExist</code> | <code>boolean</code> | Item existence flag reported in the product detail. |
| <code>data.success</code> | <code>boolean</code> | Success flag reported inside the product detail data. |
| <code>data.areaLimit</code> | <code>boolean</code> | Whether a regional restriction is reported for the item. |
| <code>data.freeShipping</code> | <code>boolean</code> | Whether the item is marked as offering free shipping. |
| <code>data.skuId</code> | <code>integer</code> | SKU ID returned alongside the product information. |
| <code>data.creativeText</code> | <code>string</code> | Promotional display text associated with the item, when available. |
| <code>data.itemPrice</code> | <code>object</code> | Item-level pricing and promotion display information. |
| <code>data.itemPrice.price</code> | <code>string</code> | Item price text returned for the listing, when available. |
| <code>data.itemPrice.originalPrice</code> | <code>string</code> | Reported original item price as text. |
| <code>data.itemPrice.promotionPrice</code> | <code>string</code> | Reported item promotional price as text. |
| <code>data.itemPrice.promotionName</code> | <code>string</code> | Display name of the item promotion. |
| <code>data.itemPrice.hasRangePrice</code> | <code>boolean</code> | Whether the price information is marked as a range. |
| <code>data.itemPrice.exchangePriceHKD</code> | <code>string</code> | Displayed price converted to Hong Kong dollars. |
| <code>data.itemPrice.exchangePriceTWD</code> | <code>string</code> | Displayed price converted to New Taiwan dollars. |
| <code>data.itemPrice.startTime</code> | <code>string</code> | Reported start time text for the price information. |
| <code>data.itemPrice.endTime</code> | <code>string</code> | Reported end time text for the price information. |
| <code>data.itemPrice.remark</code> | <code>string</code> | Display note provided with the price information. |
| <code>data.coupon</code> | <code>object</code> | Coupon information returned for the item. |
| <code>data.coupon.coupon</code> | <code>object</code> | Coupon details embedded in the response. |
| <code>data.coupon.coupon.couponClickUrl</code> | <code>string</code> | Link provided for the coupon, when available. |
| <code>data.coupon.coupon.couponInfo</code> | <code>string</code> | Displayed coupon description. |
| <code>data.coupon.coupon.couponPrice</code> | <code>integer</code> | Reported coupon amount as an integer value. |
| <code>data.coupon.coupon.couponStartTime</code> | <code>string</code> | Reported start time text for the coupon. |
| <code>data.coupon.coupon.couponEndTime</code> | <code>string</code> | Reported end time text for the coupon. |
| <code>data.coupon.coupon.couponRemainCount</code> | <code>integer</code> | Reported number of coupons remaining. |
| <code>data.coupon.coupon.couponTotalCount</code> | <code>integer</code> | Reported total number of coupons. |
| <code>data.coupon.coupon.itemUrl</code> | <code>string</code> | Item listing link provided with the coupon information. |
| <code>data.itemSkuDO</code> | <code>object</code> | SKU details, specification combinations, and selectable options. |
| <code>data.itemSkuDO.skuList</code> | <code>object</code> | SKU map whose keys are SKU IDs represented as strings. Pricing fields can be absent for some items. |
| <code>data.itemSkuDO.skuList.{key}</code> | <code>object</code> | Details of the SKU identified by the map key. |
| <code>data.itemSkuDO.skuList.{key}.skuId</code> | <code>integer</code> | SKU ID, returned as an integer. |
| <code>data.itemSkuDO.skuList.{key}.propPath</code> | <code>string</code> | SKU specification path. Each pair joins a property ID and value ID with a colon, and multiple pairs are separated by semicolons. |
| <code>data.itemSkuDO.skuList.{key}.quantity</code> | <code>string</code> | Reported quantity for this SKU, returned as text. |
| <code>data.itemSkuDO.skuList.{key}.price</code> | <code>string</code> | Reported price text for this SKU, when available. |
| <code>data.itemSkuDO.skuList.{key}.priceMoney</code> | <code>integer</code> | Reported integer representation of this SKU price, when available. |
| <code>data.itemSkuDO.skuPVPairList</code> | <code>array</code> | List of SKU IDs and their specification paths. |
| <code>data.itemSkuDO.skuPVPairList[]</code> | <code>object</code> | One SKU and its selected specification combination. |
| <code>data.itemSkuDO.skuPVPairList[].skuId</code> | <code>integer</code> | SKU ID, returned as an integer. |
| <code>data.itemSkuDO.skuPVPairList[].propPath</code> | <code>string</code> | SKU specification path. Each pair joins a property ID and value ID with a colon, and multiple pairs are separated by semicolons. |
| <code>data.itemSkuDO.skuPropertyList</code> | <code>array</code> | Specification properties that define the item variants. |
| <code>data.itemSkuDO.skuPropertyList[]</code> | <code>object</code> | One specification property and its options. |
| <code>data.itemSkuDO.skuPropertyList[].pid</code> | <code>integer</code> | Specification property ID, returned as an integer. |
| <code>data.itemSkuDO.skuPropertyList[].name</code> | <code>string</code> | Display name of the specification property. |
| <code>data.itemSkuDO.skuPropertyList[].propertyValues</code> | <code>array</code> | Selectable values for the specification property. |
| <code>data.itemSkuDO.skuPropertyList[].propertyValues[]</code> | <code>object</code> | One option value for the specification property. |
| <code>data.itemSkuDO.skuPropertyList[].propertyValues[].vid</code> | <code>integer</code> | Option value ID, returned as an integer. |
| <code>data.itemSkuDO.skuPropertyList[].propertyValues[].name</code> | <code>string</code> | Display name of the option value. |
| <code>data.itemSkuDO.skuPropertyList[].propertyValues[].image</code> | <code>string</code> | Image URL for the option value, when available. |
| <code>data.props</code> | <code>object</code> | Grouped product attributes displayed for the item. |
| <code>data.props.groupProps</code> | <code>array</code> | Attribute groups with platform-provided group and attribute names. |
| <code>data.props.groupProps[]</code> | <code>object</code> | An object keyed by attribute group name. |
| <code>data.props.groupProps[].{key}</code> | <code>array</code> | List of attributes for the group identified by the map key. |
| <code>data.props.groupProps[].{key}[]</code> | <code>object</code> | An object keyed by the displayed attribute name. |
| <code>data.props.groupProps[].{key}[].{key}</code> | <code>string</code> | Displayed text value of the attribute named by the key. |
| <code>data.seller</code> | <code>object</code> | Shop and seller information returned with the item. |
| <code>data.seller.shopId</code> | <code>integer</code> | Marketplace shop ID, returned as an integer. |
| <code>data.seller.userId</code> | <code>integer</code> | Marketplace account ID of the seller, returned as an integer. |
| <code>data.seller.shopName</code> | <code>string</code> | Shop display name. |
| <code>data.seller.shopIcon</code> | <code>string</code> | Shop icon image URL. |
| <code>data.seller.shopUrl</code> | <code>string</code> | Link to the shop page. |
| <code>data.seller.taoShopUrl</code> | <code>string</code> | Another shop link returned for this listing. |
| <code>data.seller.sellerType</code> | <code>string</code> | Seller type code reported by the marketplace. |
| <code>data.seller.creditLevel</code> | <code>string</code> | Seller credit level reported as text. |
| <code>data.seller.allItemCount</code> | <code>integer</code> | Reported count of items in the shop. |
| <code>data.seller.newItemCount</code> | <code>integer</code> | Reported count of new items in the shop. |
| <code>data.seller.showShopLinkIcon</code> | <code>boolean</code> | Whether the presentation metadata indicates that the shop link icon is shown. |
| <code>data.seller.evaluates</code> | <code>array</code> | Ratings reported by the marketplace for the shop. |
| <code>data.seller.evaluates[]</code> | <code>object</code> | One reported shop rating. |
| <code>data.seller.evaluates[].title</code> | <code>string</code> | Display title of the shop rating criterion. |
| <code>data.seller.evaluates[].score</code> | <code>string</code> | Reported score for the specified criterion, returned as text. |
| <code>data.seller.evaluates[].level</code> | <code>string</code> | Reported level code for the score. |
| <code>data.seller.evaluates[].type</code> | <code>string</code> | Reported rating criterion type code. |
| <code>data.itemTrade</code> | <code>object</code> | Sales and payment information returned with the item. |
| <code>data.itemTrade.soldQuantityTotal</code> | <code>string</code> | Reported total quantity sold, returned as display text. |
| <code>data.itemTrade.paymentList</code> | <code>array</code> | Payment options displayed with the product. |
| <code>data.itemTrade.paymentList[]</code> | <code>object</code> | One displayed payment option. |
| <code>data.itemTrade.paymentList[].name</code> | <code>string</code> | Display name of the payment option. |
| <code>data.itemTrade.paymentList[].logo</code> | <code>string</code> | Logo image URL for the payment option. |
| <code>data.merchantReturnRegion</code> | <code>array</code> | Regions listed for merchant returns. |
| <code>data.merchantReturnRegion[]</code> | <code>string</code> | A region listed for merchant returns. |
| <code>data.service</code> | <code>object</code> | Merchant service information associated with the item. |
| <code>data.service.remarkUrl</code> | <code>string</code> | Link provided for the service details. |
| <code>data.rate</code> | <code>object</code> | Review breakdown and selected reviews in the product detail. |
| <code>data.rate.totalCount</code> | <code>string</code> | Reported total number of reviews, returned as text. |
| <code>data.rate.hasAppendCount</code> | <code>string</code> | Reported count of reviews with follow-up content, returned as text. |
| <code>data.rate.hasMediaCount</code> | <code>string</code> | Reported count of reviews with media, returned as text. |
| <code>data.rate.hasNextPage</code> | <code>boolean</code> | Whether the review preview indicates that more reviews are available. |
| <code>data.rate.keywords</code> | <code>array</code> | Review keywords and their reported counts. |
| <code>data.rate.keywords[]</code> | <code>object</code> | One review keyword displayed for the product. |
| <code>data.rate.keywords[].word</code> | <code>string</code> | Display text of the review keyword. |
| <code>data.rate.keywords[].count</code> | <code>integer</code> | Reported count for the review keyword. |
| <code>data.rate.keywords[].labelId</code> | <code>string</code> | Review keyword label ID, returned as text. |
| <code>data.rate.keywords[].type</code> | <code>integer</code> | Reported type code of the review keyword. |
| <code>data.rate.rateList</code> | <code>array</code> | Reviews included with the item details. |
| <code>data.rate.rateList[]</code> | <code>object</code> | One review returned for the item. |
| <code>data.rate.rateList[].userName</code> | <code>string</code> | Displayed name of the reviewer. |
| <code>data.rate.rateList[].headPic</code> | <code>string</code> | Image URL for the reviewer’s displayed avatar. |
| <code>data.rate.rateList[].content</code> | <code>string</code> | Text content of the review. |
| <code>data.rate.rateList[].dateTime</code> | <code>string</code> | Reported publication time text for the review. |
| <code>data.rate.rateList[].skuInfo</code> | <code>string</code> | Displayed SKU information associated with the review. |
| <code>data.rate.rateList[].commentScore</code> | <code>string</code> | Reported review score as text. |
| <code>data.rate.rateList[].likeCount</code> | <code>integer</code> | Reported number of likes on the review. |
| <code>data.rate.rateList[].images</code> | <code>array</code> | Image URLs attached to the review, when available. |
| <code>data.rate.rateList[].images[]</code> | <code>string</code> | URL of an image attached to the review. |
| <code>data.rate.rateList[].appendRateList</code> | <code>array</code> | Follow-up content for the review, when returned. |
| <code>data.rate.rateList[].appendRateList[]</code> | <code>object</code> | One follow-up entry for the review. |
| <code>data.rate.rateList[].appendRateList[].content</code> | <code>string</code> | Text content of the follow-up review. |
| <code>data.rate.rateList[].appendRateList[].appendIntervalDay</code> | <code>string</code> | Reported interval in days before the follow-up, returned as text. |
| <code>data.rate.rateList[].appendRateList[].images</code> | <code>array</code> | Image URLs attached to the follow-up review, when available. |
| <code>data.rate.rateList[].appendRateList[].images[]</code> | <code>string</code> | URL of an image attached to the follow-up review. |
| <code>data.itemAskDOList</code> | <code>array</code> | Product questions and included answers, when available. |
| <code>data.itemAskDOList[]</code> | <code>object</code> | One question associated with the product. |
| <code>data.itemAskDOList[].askContent</code> | <code>string</code> | Text of the question. |
| <code>data.itemAskDOList[].askUserNick</code> | <code>string</code> | Displayed nickname of the person who asked the question. |
| <code>data.itemAskDOList[].createTime</code> | <code>string</code> | Reported creation time text for the question. |
| <code>data.itemAskDOList[].answerList</code> | <code>array</code> | Answers included with the question. |
| <code>data.itemAskDOList[].answerList[]</code> | <code>object</code> | One answer to the product question. |
| <code>data.itemAskDOList[].answerList[].answerContent</code> | <code>string</code> | Text of the answer. |
| <code>data.itemAskDOList[].answerList[].createTime</code> | <code>string</code> | Reported creation time text for the answer. |
| <code>data.itemAskDOList[].answerList[].userNick</code> | <code>string</code> | Displayed nickname of the person who answered. |
| <code>data.mainItemInfo</code> | <code>object</code> | Display information for the main listing. |
| <code>data.mainItemInfo.itemId</code> | <code>string</code> | Item ID as text in the listing summary. |
| <code>data.mainItemInfo.itemName</code> | <code>string</code> | Display name in the listing summary. |
| <code>data.mainItemInfo.pic</code> | <code>string</code> | Product image URL in the listing summary. |
| <code>data.mainItemInfo.url</code> | <code>string</code> | Product link in the listing summary, when provided. |
| <code>data.mainItemInfo.afterCouponAmountPrice</code> | <code>string</code> | Displayed after-coupon price text in the listing summary. |
| <code>data.mainItemInfo.zkFinalPrice</code> | <code>string</code> | Displayed final discounted price in the listing summary, when provided. |
| <code>data.mainItemInfo.promotionModel</code> | <code>object</code> | Promotion presentation details, when returned. |
| <code>data.mainItemInfo.promotionModel.promotionPriceModel</code> | <code>object</code> | Reported amounts and display text for the promotion. |
| <code>data.mainItemInfo.promotionModel.promotionPriceModel.promotionPrice</code> | <code>string</code> | Reported amount of the promotional price, returned as text. |
| <code>data.mainItemInfo.promotionModel.promotionPriceModel.promotionPriceDescDisplay</code> | <code>string</code> | Displayed description for the promotional price. |
| <code>data.mainItemInfo.promotionModel.promotionPriceModel.promotionPriceDisplay</code> | <code>string</code> | Displayed text for the promotional price. |
| <code>data.mainItemInfo.promotionModel.promotionPriceModel.zkPrice</code> | <code>string</code> | Reported discounted price amount, returned as text. |
| <code>data.mainItemInfo.promotionModel.promotionPriceModel.zkPriceDisplay</code> | <code>string</code> | Displayed text for the discounted price. |
| <code>data.mainItemInfo.promotionModel.promotionTagModel</code> | <code>array</code> | Labels used to display the promotion. |
| <code>data.mainItemInfo.promotionModel.promotionTagModel[]</code> | <code>object</code> | One promotion display label. |
| <code>data.mainItemInfo.promotionModel.promotionTagModel[].tagDisplay</code> | <code>string</code> | Displayed promotion label text. |
| <code>data.mainItemInfo.promotionModel.promotionTagModel[].tagType</code> | <code>string</code> | Reported type code for the promotion label. |
| <code>data.mainItemInfo.promotionModel.promotionTagModel[].tagTypeDisplay</code> | <code>string</code> | Displayed name of the promotion label type. |
| <code>data.mainItemInfo.taobaoPromotionModel</code> | <code>object</code> | Marketplace promotion summary, when available. |
| <code>data.mainItemInfo.taobaoPromotionModel.finalPromotionInfo</code> | <code>object</code> | Final promotional price information returned in the summary. |
| <code>data.mainItemInfo.taobaoPromotionModel.finalPromotionInfo.finalPromotionPrice</code> | <code>string</code> | Reported final promotional price as text. |

</div>

## Response Example

<ApiExampleSection :api='JSON.parse("\"/api/taobao/get-item-detail/v1\"")' />

