https://api.nexscope.ai/alibaba1688/productDetailRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/alibaba1688/productDetail |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
offerId | string | required | 1688 product ID in positive integer format; strings must be used to avoid loss of precision in large numbers; maximum length 1000 Example: 1234567890123456789 |
country | string | optional | Upstream compatibility field; usually omitted for this API Example: en |
currency | string | optional | Three-letter currency code, such as `USD`, `HKD`; the server will convert it to uppercase; the maximum length is 3 Example: USD |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "0",
"data": {
"offerId": "1234567890123456789",
"saleInfo": {
"priceRanges": [
{
"price": "4.20",
"startQuantity": 2
}
],
"retailPrice": "4.80"
},
"skuList": [
{
"amountOnSale": 100,
"fenxiaoPriceInfo": {
"offerPrice": "4.20",
"onePiecePrice": "4.80"
},
"price": "4.20",
"retailPrice": "4.80",
"skuId": "456789012345678901",
"specId": "example-spec"
}
],
"subject": "Example product",
"tags": [
{
"key": "isSelect",
"value": true
}
],
"certificates": [],
"offerIdentities": [],
"productAttributes": [],
"sellingPoints": []
},
"msg": null,
"time": "2026-10-20T00:00:00Z",
"traceId": null,
"ts": "0"
}Response fields
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | optional | Nexscope transport/business envelope code; 0 means the request was processed. Inspect data for operation outcomes. |
cost | string | optional | Processing time in milliseconds, not credits. |
data | object | optional | Data value used by this API operation. |
data.batchNumber | integer | optional | One lot quantity |
data.categoryId | string | optional | Current category ID |
data.categoryName | string | optional | Category name, may be missing |
data.certificates | array | optional | Certificates value used by this API operation. |
data.certificates[] | object | required | Item in data certificates. |
data.certificates[].certificateCode | string | optional | Certificate code value used by this API operation. |
data.certificates[].certificateName | string | optional | Certificate name value used by this API operation. |
data.certificates[].certificatePhotoList | array | optional | Certificate photo list value used by this API operation. |
data.certificates[].certificatePhotoList[] | string | required | Item in data certificates[] certificatePhotoList. |
data.channelPrice | object | optional | Channel price value used by this API operation. |
data.channelPrice.skuPrices | array | optional | Sku prices value used by this API operation. |
data.channelPrice.skuPrices[] | object | required | Item in data channelPrice skuPrices. |
data.channelPrice.skuPrices[].currentPrice | number | optional | Current price value used by this API operation. |
data.channelPrice.skuPrices[].skuId | string | optional | Exact positive integer identifier. Send as a JSON string. Pattern: ^[1-9][0-9]*$ |
data.companyName | string | optional | Supplier/Store Name |
data.createDate | string | optional | Product creation time |
data.description | string | optional | Product details in Chinese, often containing HTML |
data.descriptionTrans | string | optional | Upstream extension details field, may be missing |
data.detailVideo | string | optional | Detailed video address |
data.invoiceInfo | object | optional | Invoice info value used by this API operation. |
data.invoiceInfo.invoiceTypes | array | optional | Invoice types value used by this API operation. |
data.invoiceInfo.invoiceTypes[] | string | required | Item in data invoiceInfo invoiceTypes. |
data.invoiceInfo.supportFastInvoice | boolean | optional | Support fast invoice value used by this API operation. |
data.invoiceInfo.supportOnlineInvoice | boolean | optional | Support online invoice value used by this API operation. |
data.invoiceInfo.taxpayerType | string | optional | Taxpayer type value used by this API operation. |
data.isJxhy | boolean | optional | Whether to select supply sources |
data.isSelect | boolean | optional | Whether to cross-border Select pallet |
data.mainVideo | string | optional | Main video address |
data.minOrderQuantity | integer | optional | Minimum minimum quantity |
data.offerId | string | optional | 1688 Product ID |
data.offerIdentities | array | optional | Product or merchant identification |
data.offerIdentities[] | any | required | Item in data offerIdentities. |
data.productAttributes | array | optional | Product attributes value used by this API operation. |
data.productAttributes[] | object | required | Item in data productAttributes. |
data.productAttributes[].attributeId | string | optional | Attribute id value used by this API operation. |
data.productAttributes[].attributeName | string | optional | Attribute name value used by this API operation. |
data.productAttributes[].attributeNameTrans | string | optional | Attribute name trans value used by this API operation. |
data.productAttributes[].value | string | optional | Value value used by this API operation. |
data.productAttributes[].valueTrans | string | optional | Value trans value used by this API operation. |
data.productCargoNumber | string | optional | Product number |
data.productImage | object | optional | Product image value used by this API operation. |
data.productImage.images | array | optional | Images value used by this API operation. |
data.productImage.images[] | string | required | Item in data productImage images. |
data.productImage.whiteImage | string | optional | White image value used by this API operation. |
data.productImageTrans | object | optional | Product image trans value used by this API operation. |
data.productImageTrans.images | array | optional | Images value used by this API operation. |
data.productImageTrans.images[] | string | required | Item in data productImageTrans images. |
data.productImageTrans.whiteImage | string | optional | White image value used by this API operation. |
data.productUrl | string | optional | 1688 product promotion link |
data.promotion | object | optional | Promotion value used by this API operation. |
data.promotion.hasPromotion | boolean | optional | Has promotion value used by this API operation. |
data.promotion.promotionType | string | optional | Promotion type value used by this API operation. |
data.saleInfo | object | optional | Sale info value used by this API operation. |
data.saleInfo.amountOnSale | integer | optional | Total merchandise inventory |
data.saleInfo.fenxiaoSaleInfo | object | optional | Fenxiao sale info value used by this API operation. |
data.saleInfo.fenxiaoSaleInfo.offerPrice | number | optional | Offer price value used by this API operation. |
data.saleInfo.fenxiaoSaleInfo.onePieceFreePostage | boolean | optional | One piece free postage value used by this API operation. |
data.saleInfo.fenxiaoSaleInfo.onePiecePrice | number | optional | One piece price value used by this API operation. |
data.saleInfo.fenxiaoSaleInfo.startQuantity | integer | optional | Start quantity value used by this API operation. |
data.saleInfo.foreignCurrencyRetailPrice | number | optional | Item-level retail price in foreign currency, applicable to purchase quantity 1 piece; missing when no currency requested, no retail price, or conversion failure |
data.saleInfo.priceRanges | array | optional | Price ranges value used by this API operation. |
data.saleInfo.priceRanges[] | object | required | Item in data saleInfo priceRanges. |
data.saleInfo.priceRanges[].foreignCurrencyPrice | number | optional | Tier price; foreignCurrency fields use requested currency, other prices use CNY. |
data.saleInfo.priceRanges[].foreignCurrencyPromotionPrice | number | optional | Tier price; foreignCurrency fields use requested currency, other prices use CNY. |
data.saleInfo.priceRanges[].price | string | optional | Tier price; foreignCurrency fields use requested currency, other prices use CNY. |
data.saleInfo.priceRanges[].promotionPrice | number | optional | Tier price; foreignCurrency fields use requested currency, other prices use CNY. |
data.saleInfo.priceRanges[].startQuantity | integer | optional | Start quantity value used by this API operation. |
data.saleInfo.quoteType | integer | optional | `0` has no SKU and is based on product quantity; `1` is based on SKU specifications; `2` has SKU and is based on product quantity |
data.saleInfo.retailPrice | string | optional | Product-level retail price (RMB), applicable to the purchase quantity of 1 piece; missing if the upstream does not have a retail price |
data.saleInfo.unitInfo | object | optional | Unit info value used by this API operation. |
data.saleInfo.unitInfo.transUnit | string | optional | Trans unit value used by this API operation. |
data.saleInfo.unitInfo.unit | string | optional | Unit value used by this API operation. |
data.secondCategoryId | string | optional | Secondary category ID |
data.sellerDataInfo | object | optional | Seller data info value used by this API operation. |
data.sellerDataInfo.afterSalesExperienceScore | string | optional | Return or exchange experience points |
data.sellerDataInfo.collect30DayWithin48HPercent | string | optional | Collection rate in the last 30 days and 48 hours |
data.sellerDataInfo.compositeServiceScore | string | optional | Comprehensive service points |
data.sellerDataInfo.consultingExperienceScore | string | optional | Consulting experience points |
data.sellerDataInfo.disputeComplaintScore | string | optional | Dispute resolution points |
data.sellerDataInfo.logisticsExperienceScore | string | optional | Logistics experience points |
data.sellerDataInfo.offerExperienceScore | string | optional | Product experience points |
data.sellerDataInfo.qualityRefundWithin30Day | string | optional | Quality refund rate in the last 30 days |
data.sellerDataInfo.repeatPurchasePercent | string | optional | Seller return rate |
data.sellerDataInfo.tradeMedalLevel | string | optional | Seller Trading Medal |
data.sellerMixSetting | object | optional | Seller mix setting value used by this API operation. |
data.sellerMixSetting.generalHunpi | boolean | optional | General hunpi value used by this API operation. |
data.sellerMixSetting.mixAmount | number | optional | Mix amount value used by this API operation. |
data.sellerMixSetting.mixNumber | integer | optional | Mix number value used by this API operation. |
data.sellerOpenId | string | optional | Merchant Encrypted ID |
data.sellingPoints | array | optional | Product selling point, may be empty |
data.sellingPoints[] | any | required | Item in data sellingPoints. |
data.shippingInfo | object | optional | Shipping info value used by this API operation. |
data.shippingInfo.officialWeight | number | optional | Official measured weight in kg |
data.shippingInfo.pkgSizeSource | string | optional | Product weight data source |
data.shippingInfo.sendGoodsAddressText | string | optional | Place of shipment |
data.shippingInfo.shippingTimeGuarantee | string | optional | Delivery guarantee |
data.shippingInfo.skuShippingDetails | array | optional | Sku shipping details value used by this API operation. |
data.shippingInfo.skuShippingDetails[] | object | required | Item in data shippingInfo skuShippingDetails. |
data.shippingInfo.skuShippingDetails[].aiWeight | number | optional | Kilograms. |
data.shippingInfo.skuShippingDetails[].height | number | optional | Centimeters. |
data.shippingInfo.skuShippingDetails[].length | number | optional | Centimeters. |
data.shippingInfo.skuShippingDetails[].officialWeight | number | optional | Kilograms. |
data.shippingInfo.skuShippingDetails[].skuId | string | optional | Exact positive integer identifier. Send as a JSON string. Pattern: ^[1-9][0-9]*$ |
data.shippingInfo.skuShippingDetails[].specId | string | optional | Spec id value used by this API operation. |
data.shippingInfo.skuShippingDetails[].weight | number | optional | Weight in kilograms. |
data.shippingInfo.skuShippingDetails[].width | number | optional | Centimeters. |
data.shippingInfo.skuShippingInfoList | array | optional | Sku shipping info list value used by this API operation. |
data.shippingInfo.skuShippingInfoList[] | object | required | Item in data shippingInfo skuShippingInfoList. |
data.shippingInfo.skuShippingInfoList[].aiWeight | number | optional | Kilograms. |
data.shippingInfo.skuShippingInfoList[].height | number | optional | Centimeters. |
data.shippingInfo.skuShippingInfoList[].length | number | optional | Centimeters. |
data.shippingInfo.skuShippingInfoList[].officialWeight | number | optional | Kilograms. |
data.shippingInfo.skuShippingInfoList[].skuId | string | optional | Exact positive integer identifier. Send as a JSON string. Pattern: ^[1-9][0-9]*$ |
data.shippingInfo.skuShippingInfoList[].specId | string | optional | Spec id value used by this API operation. |
data.shippingInfo.skuShippingInfoList[].weight | number | optional | Weight in grams. |
data.shippingInfo.skuShippingInfoList[].width | number | optional | Centimeters. |
data.shippingInfo.weight | number | optional | Product weight, unit kg |
data.skuList | array | optional | Sku list value used by this API operation. |
data.skuList[] | object | required | Item in data skuList. |
data.skuList[].amountOnSale | integer | optional | Available inventory |
data.skuList[].attributes | array | optional | Attributes value used by this API operation. |
data.skuList[].attributes[] | object | required | Item in data skuList[] attributes. |
data.skuList[].attributes[].attributeId | string | optional | Attribute id value used by this API operation. |
data.skuList[].attributes[].attributeName | string | optional | Attribute name value used by this API operation. |
data.skuList[].attributes[].skuImageUrl | string | optional | Sku image url value used by this API operation. |
data.skuList[].attributes[].value | string | optional | Value value used by this API operation. |
data.skuList[].cargoNumber | string | optional | SKU item number |
data.skuList[].consignPrice | string | optional | Dropshipping price; the upstream obsolete compatibility field may be missing |
data.skuList[].fenxiaoPriceInfo | object | optional | Fenxiao price info value used by this API operation. |
data.skuList[].fenxiaoPriceInfo.foreignCurrencyPrice | number | optional | Foreign currency value. |
data.skuList[].fenxiaoPriceInfo.foreignCurrencyPromotionPrice | number | optional | Foreign currency value. |
data.skuList[].fenxiaoPriceInfo.offerPrice | string | optional | CNY price. |
data.skuList[].fenxiaoPriceInfo.onePiecePrice | string | optional | CNY price. |
data.skuList[].foreignCurrencyRetailPrice | number | optional | SKU retail price in foreign currency, applicable to purchase quantity 1 piece; missing when no currency requested, no retail price, or conversion failure |
data.skuList[].price | string | optional | SKU price (RMB); in the new retail price model, it is the wholesale price when the purchase quantity is greater than or equal to 2 pieces. The semantics of the old product model are combined with ladder and order preview judgments. |
data.skuList[].promotionPrice | string | optional | marketing price |
data.skuList[].retailPrice | string | optional | SKU retail price (RMB), applicable to purchase quantity 1 piece; missing if the upstream does not have a retail price |
data.skuList[].skuId | string | optional | SKU ID |
data.skuList[].specId | string | optional | Specification ID |
data.soldOut | string | optional | Product sales |
data.sourceType | string | optional | Data source, currently `1688` |
data.status | string | optional | Product status |
data.subject | string | optional | Chinese title |
data.subjectTrans | string | optional | Upstream extension header field, may be empty or the same as `subject` |
data.tags | array | optional | Tags value used by this API operation. |
data.tags[] | object | required | Item in data tags. |
data.tags[].key | string | optional | Key value used by this API operation. |
data.tags[].value | boolean | optional | Value value used by this API operation. |
data.thirdCategoryId | string | optional | Third-level category ID |
data.topCategoryId | string | optional | First level category ID |
data.tradeScore | string | optional | Product Transaction Rating |
data.type | string | optional | Result style, currently `productDetail` |
msg | string | null | optional | Safe response message. |
time | string | optional | Server response time. |
traceId | string | null | optional | Request trace identifier. |
ts | string | optional | Server timestamp. |
Responses
| Code | Description |
|---|---|
| 200 | Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result. |
| 429 | Execution admission rate limit; honor Retry-After when present. |
| 503 | Execution admission is temporarily unavailable; honor Retry-After when present. |
| Opt-in | X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses. |
Data source, freshness, and limitations
Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.