1688 Product Detail

Retrieve public 1688 product, SKU, pricing, logistics, and supplier details. Call the 1688 Product Detail API via REST or MCP in your app or AI agent.

CostRecent 10 credits / call

Try online

POST · https://api.nexscope.ai/alibaba1688/productDetailMCP · nexscope_1688_product_detail

Choose an integration method

1688 Sourcing

What this API does

Retrieve public 1688 product, SKU, pricing, logistics, and supplier details. The request accepts offerId, country, currency. Its documented result includes batchNumber, categoryId, categoryName, certificates.certificateCode, certificates.certificateName, certificates.certificatePhotoList, channelPrice.skuPrices.currentPrice, channelPrice.skuPrices.skuId.

1688 Product Detail API use cases

Inspect a candidate product

To inspect a candidate product, a marketplace analyst submits offerId and country to 1688 Product Detail. The returned batchNumber, categoryId, categoryName help inspect the documented attributes of the candidate product.

Compare listing details

A marketplace analyst uses 1688 Product Detail with offerId and country to compare listing details. The returned batchNumber, categoryId, categoryName help compare product details with another shortlisted listing.

Prepare product evidence for a sourcing review

For this workflow, a marketplace analyst calls 1688 Product Detail with offerId and country to prepare product evidence for a sourcing review. The result helps record product facts before a sourcing discussion.

1688 Product Detail API FAQ

What does the 1688 Product Detail API return?

Retrieve public 1688 product, SKU, pricing, logistics, and supplier details. The documented output includes batchNumber, categoryId, categoryName, certificates.certificateCode, certificates.certificateName, certificates.certificatePhotoList, channelPrice.skuPrices.currentPrice, channelPrice.skuPrices.skuId. It corresponds to the supplied offerId, country, currency. Optional fields can be absent; a missing value should not be interpreted as a measured zero. Example values illustrate the response shape, rather than live account results.

How many credits does the 1688 Product Detail API cost?

The current documented cost is Recent 10 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the 1688 Product Detail API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/alibaba1688/productDetail with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_1688_product_detail. Use the MCP arguments shown in the MCP guide, or switch Online test to MCP to review its request before adding it to your app.

View plans and credits Connect this API with MCP

Try this API

Endpoint

https://api.nexscope.ai/alibaba1688/productDetail

MCP method

nexscope_1688_product_detail

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/alibaba1688/productDetail

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/alibaba1688/productDetail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "offerId": "123456789012"
}'

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

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.

View parameters & response Try online

All categories/ 1688 Sourcing

POSThttps://api.nexscope.ai/alibaba1688/productDetail

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Open tester

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
`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

Code example

{
  "offerId": "123456789012"
}

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "code": 0,
  "cost": "-1",
  "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
      }
    ]
  },
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}

Response fields

Name	Type	Required	Description
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`data`	`any`	required	Data value used by this API operation.
`msg`	`string \| null`	required	Msg value used by this API operation.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`traceId`	`string \| null`	required	Trace id value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.batchNumber`	`any`	optional	Batch number value used by this API operation.
`data.categoryId`	`any`	optional	Category id value used by this API operation.
`data.categoryName`	`any`	optional	Category name value used by this API operation.
`data.certificates`	`any`	optional	Certificates value used by this API operation.
`data.channelPrice`	`any`	optional	Channel price value used by this API operation.
`data.companyName`	`any`	optional	Company name value used by this API operation.
`data.createDate`	`any`	optional	Create date value used by this API operation.
`data.description`	`any`	optional	Description value used by this API operation.
`data.descriptionTrans`	`any`	optional	Description trans value used by this API operation.
`data.detailVideo`	`any`	optional	Detail video value used by this API operation.
`data.invoiceInfo`	`any`	optional	Invoice info value used by this API operation.
`data.isJxhy`	`any`	optional	Is jxhy value used by this API operation.
`data.isSelect`	`any`	optional	Is select value used by this API operation.
`data.mainVideo`	`any`	optional	Main video value used by this API operation.
`data.minOrderQuantity`	`any`	optional	Min order quantity value used by this API operation.
`data.offerId`	`any`	optional	Offer id value used by this API operation.
`data.offerIdentities`	`any`	optional	Offer identities value used by this API operation.
`data.productAttributes`	`any`	optional	Product attributes value used by this API operation.
`data.productCargoNumber`	`any`	optional	Product cargo number value used by this API operation.
`data.productImage`	`any`	optional	Product image value used by this API operation.
`data.productImageTrans`	`any`	optional	Product image trans value used by this API operation.
`data.productUrl`	`any`	optional	Product url value used by this API operation.
`data.promotion`	`any`	optional	Promotion value used by this API operation.
`data.saleInfo`	`any`	optional	Sale info value used by this API operation.
`data.secondCategoryId`	`any`	optional	Second category id value used by this API operation.
`data.sellerDataInfo`	`any`	optional	Seller data info value used by this API operation.
`data.sellerMixSetting`	`any`	optional	Seller mix setting value used by this API operation.
`data.sellerOpenId`	`any`	optional	Seller open id value used by this API operation.
`data.sellingPoints`	`any`	optional	Selling points value used by this API operation.
`data.shippingInfo`	`any`	optional	Shipping info value used by this API operation.
`data.skuList`	`any`	optional	Sku list value used by this API operation.
`data.soldOut`	`any`	optional	Sold out value used by this API operation.
`data.sourceType`	`any`	optional	Source type value used by this API operation.
`data.status`	`any`	optional	Status value used by this API operation.
`data.subject`	`any`	optional	Subject value used by this API operation.
`data.subjectTrans`	`any`	optional	Subject trans value used by this API operation.
`data.tags`	`any`	optional	Tags value used by this API operation.
`data.thirdCategoryId`	`any`	optional	Third category id value used by this API operation.
`data.topCategoryId`	`any`	optional	Top category id value used by this API operation.
`data.tradeScore`	`any`	optional	Trade score value used by this API operation.
`data.type`	`any`	optional	Type value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.batchNumber`	`integer`	optional	One lot quantity

Any of option 2

Name	Type	Required	Description
`data.batchNumber`	`null`	optional	Batch number value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.categoryId`	`string`	optional	Current category ID

Any of option 2

Name	Type	Required	Description
`data.categoryId`	`null`	optional	Category id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.categoryName`	`string`	optional	Category name, may be missing

Any of option 2

Name	Type	Required	Description
`data.categoryName`	`null`	optional	Category name value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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.

Any of option 2

Name	Type	Required	Description
`data.certificates`	`null`	optional	Certificates value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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]*$

Any of option 2

Name	Type	Required	Description
`data.channelPrice`	`null`	optional	Channel price value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.companyName`	`string`	optional	Supplier/Store Name

Any of option 2

Name	Type	Required	Description
`data.companyName`	`null`	optional	Company name value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.createDate`	`string`	optional	Product creation time

Any of option 2

Name	Type	Required	Description
`data.createDate`	`null`	optional	Create date value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.description`	`string`	optional	Product details in Chinese, often containing HTML

Any of option 2

Name	Type	Required	Description
`data.description`	`null`	optional	Description value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.descriptionTrans`	`string`	optional	Upstream extension details field, may be missing

Any of option 2

Name	Type	Required	Description
`data.descriptionTrans`	`null`	optional	Description trans value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.detailVideo`	`string`	optional	Detailed video address

Any of option 2

Name	Type	Required	Description
`data.detailVideo`	`null`	optional	Detail video value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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.

Any of option 2

Name	Type	Required	Description
`data.invoiceInfo`	`null`	optional	Invoice info value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.isJxhy`	`boolean`	optional	Whether to select supply sources

Any of option 2

Name	Type	Required	Description
`data.isJxhy`	`null`	optional	Is jxhy value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.isSelect`	`boolean`	optional	Whether to cross-border Select pallet

Any of option 2

Name	Type	Required	Description
`data.isSelect`	`null`	optional	Is select value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.mainVideo`	`string`	optional	Main video address

Any of option 2

Name	Type	Required	Description
`data.mainVideo`	`null`	optional	Main video value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.minOrderQuantity`	`integer`	optional	Minimum minimum quantity

Any of option 2

Name	Type	Required	Description
`data.minOrderQuantity`	`null`	optional	Min order quantity value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.offerId`	`string`	optional	1688 Product ID

Any of option 2

Name	Type	Required	Description
`data.offerId`	`null`	optional	Offer id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.offerIdentities`	`array`	optional	Product or merchant identification
`data.offerIdentities[]`	`any`	required	Item in data offerIdentities.

Any of option 2

Name	Type	Required	Description
`data.offerIdentities`	`null`	optional	Offer identities value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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.

Any of option 2

Name	Type	Required	Description
`data.productAttributes`	`null`	optional	Product attributes value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.productCargoNumber`	`string`	optional	Product number

Any of option 2

Name	Type	Required	Description
`data.productCargoNumber`	`null`	optional	Product cargo number value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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.

Any of option 2

Name	Type	Required	Description
`data.productImage`	`null`	optional	Product image value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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.

Any of option 2

Name	Type	Required	Description
`data.productImageTrans`	`null`	optional	Product image trans value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.productUrl`	`string`	optional	1688 product promotion link

Any of option 2

Name	Type	Required	Description
`data.productUrl`	`null`	optional	Product url value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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.

Any of option 2

Name	Type	Required	Description
`data.promotion`	`null`	optional	Promotion value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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	Wholesale tier price in CNY, preserved as a decimal string.
`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.

Any of option 2

Name	Type	Required	Description
`data.saleInfo`	`null`	optional	Sale info value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.secondCategoryId`	`string`	optional	Secondary category ID

Any of option 2

Name	Type	Required	Description
`data.secondCategoryId`	`null`	optional	Second category id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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

Any of option 2

Name	Type	Required	Description
`data.sellerDataInfo`	`null`	optional	Seller data info value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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.

Any of option 2

Name	Type	Required	Description
`data.sellerMixSetting`	`null`	optional	Seller mix setting value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.sellerOpenId`	`string`	optional	Merchant Encrypted ID

Any of option 2

Name	Type	Required	Description
`data.sellerOpenId`	`null`	optional	Seller open id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.sellingPoints`	`array`	optional	Product selling point, may be empty
`data.sellingPoints[]`	`any`	required	Item in data sellingPoints.

Any of option 2

Name	Type	Required	Description
`data.sellingPoints`	`null`	optional	Selling points value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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

Any of option 2

Name	Type	Required	Description
`data.shippingInfo`	`null`	optional	Shipping info value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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, preserved as a decimal string.
`data.skuList[].fenxiaoPriceInfo.onePiecePrice`	`string`	optional	CNY price, preserved as a decimal string.
`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

Any of option 2

Name	Type	Required	Description
`data.skuList`	`null`	optional	Sku list value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.soldOut`	`string`	optional	Product sales

Any of option 2

Name	Type	Required	Description
`data.soldOut`	`null`	optional	Sold out value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.sourceType`	`string`	optional	Data source, currently `1688`

Any of option 2

Name	Type	Required	Description
`data.sourceType`	`null`	optional	Source type value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.status`	`string`	optional	Product status

Any of option 2

Name	Type	Required	Description
`data.status`	`null`	optional	Status value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.subject`	`string`	optional	Chinese title

Any of option 2

Name	Type	Required	Description
`data.subject`	`null`	optional	Subject value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.subjectTrans`	`string`	optional	Upstream extension header field, may be empty or the same as `subject`

Any of option 2

Name	Type	Required	Description
`data.subjectTrans`	`null`	optional	Subject trans value used by this API operation.

Any of option 1

Name	Type	Required	Description
`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	Whether the product has this tag.

Any of option 2

Name	Type	Required	Description
`data.tags`	`null`	optional	Tags value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.thirdCategoryId`	`string`	optional	Third-level category ID

Any of option 2

Name	Type	Required	Description
`data.thirdCategoryId`	`null`	optional	Third category id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.topCategoryId`	`string`	optional	First level category ID

Any of option 2

Name	Type	Required	Description
`data.topCategoryId`	`null`	optional	Top category id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.tradeScore`	`string`	optional	Product Transaction Rating

Any of option 2

Name	Type	Required	Description
`data.tradeScore`	`null`	optional	Trade score value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data.type`	`string`	optional	Result style, currently `productDetail`

Any of option 2

Name	Type	Required	Description
`data.type`	`null`	optional	Type value used by this API operation.

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

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.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_1688_product_detail",
    "arguments": {
      "offerId": "1040473674152"
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /mcp/legacy

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

At least 10 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint

/alibaba1688/productDetail

MCP method

nexscope_1688_product_detail

API key*

JSON payload*

cURL

curl -X POST \
  https://api.nexscope.ai/alibaba1688/productDetail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "offerId": "123456789012" }'

Response

No response yet. Run the request to see the response here.

Related APIs

1688 Bestselling Products

Query 1688 bestseller charts for wholesale sourcing and product research.

1688 Product Search

Search 1688 wholesale products for sourcing, supplier discovery, and product selection across Alibaba's domestic B2B marketplace.

1688 Search By Image

Find visually similar 1688 supplier products from an image URL.