1688 Sourcing

1688 Sourcing: product Billboard API

1688 Sourcing: product Billboard API.

MCP tool name

nexscope_data_dl_product_billboard

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-dl-product-billboard-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_dl_product_billboard",
    "arguments": {
      "date": "2026-03-01",
      "keyWord": "phone case",
      "pageIndex": 1,
      "pageSize": 20,
      "pageType": 3,
      "sortField": "orderCount",
      "sortType": "desc"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`keyWord`	`string`	optional	Product search keyword, must be in Chinese, maximum length 50 Example: {}
`date`	`string`	optional	Query time; the weekly list passes the Sunday date of the week (the longest is nearly 90 days), the monthly list passes the first day of the month (the longest is the last year) Example: {}
`pageType`	`integer`	optional	List type: `2` weekly list, `3` monthly list Example: 3
`pageIndex`	`integer`	optional	Page number, starting from 1 Example: 1
`pageSize`	`integer`	optional	Return quantity per page, range 10-100 Example: 20
`sortField`	`string`	optional	`orderCount` sales number, `saleCount` sales number, `saleVolume` estimated sales, `offerCreateTime` shelf time, `price` wholesale price, `consignPrice` consignment price Example: orderCount
`sortType`	`string`	optional	Sorting type: `desc` descending order, `asc` ascending order Example: desc
`searchType`	`integer`	optional	Product keyword search: `1` fuzzy matching, `3` precise matching Example: 1
`offerType`	`integer`	optional	Product identification: `0` is not limited, `2` is new, `3` is carefully selected by 1688, `4` is cross-border, `5` supports customization, `6` is the treasure of the store Example: 0
`companyType`	`integer`	optional	Company type: `0` unlimited, `1` shop, `2` factory Example: {}
`shiLiType`	`string`	optional	Seller membership type, separate multiple choices with commas: `superFactory` super factory, `Power` powerful merchant, `TrustPass` integrity member Example: {}
`beginTpYear`	`integer`	optional	Start the Integrity Pass period Example: {}
`endTpYear`	`integer`	optional	End of integrity pass period Example: {}
`beginPrice`	`number`	optional	Wholesale price starting value Example: {}
`endPrice`	`number`	optional	wholesale price ending value Example: {}
`beginConsignPrice`	`number`	optional	Starting value of agency price Example: {}
`endConsignPrice`	`number`	optional	The end value of the agency price Example: {}
`beginOrderCount`	`integer`	optional	Starting value of number of sales Example: {}
`endOrderCount`	`integer`	optional	Sales end value Example: {}
`beginSaleCount`	`integer`	optional	Starting value of sales units Example: {}
`endSaleCount`	`integer`	optional	Sales end value Example: {}
`beginSaleVolume`	`number`	optional	sales starting value Example: {}
`endSaleVolume`	`number`	optional	sales end value Example: {}
`beginStartQuantity`	`integer`	optional	Starting batch size Example: {}
`endStartQuantity`	`integer`	optional	end batch Example: {}
`beginOfferCreateTime`	`string`	optional	Starting value of shelf time, format `YYYY-MM-DD` Example: {}
`endOfferCreateTime`	`string`	optional	Shelf time end value, format `YYYY-MM-DD` Example: {}
`sendTime`	`string`	optional	Shipping time, multiple selections separated by commas: `24`, `48`, `72` hours Example: {}
`proxyRights`	`string`	optional	For drop-shipping rights, multiple options must be separated by commas: `4360897`, free shipping for one piece, `449154`, purchase first, pay later Example: {}
`shopService`	`string`	optional	Seller services, multiple selections separated by commas: `4057409` Safe Purchase, `888777` In-depth Certification Report Example: {}
`buyerProtections`	`string`	optional	Rights protection, separate multiple choices with commas: `Free shipping for goods`, `7-day return guarantee`, `Support freight insurance` Example: {}
`faceToFaceSupport`	`string`	optional	Farewell support, multiple selections separated by commas: `441218` Taobao, `386434` Douyin, `422914` Pinduoduo, `422978` Xiaohongshu, `386370` Kuaishou Example: {}
`productIds`	`string`	optional	Product ID, multiple separated by commas, up to 20 Example: {}
`goodsUrl`	`string`	optional	Product link address Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of records Example: {}
`type`	`string`	optional	rendering style Example: {}
`columns`	`array`	optional	Render column definition Example: {}
`products`	`array`	optional	Product list Example: {}
`offerId`	`string`	optional	Product ID Example: {}
`asin`	`string`	optional	Item number Example: {}
`title`	`string`	optional	Product title Example: {}
`price`	`number`	optional	wholesale price Example: {}
`consignPrice`	`number`	optional	Price on behalf of others Example: {}
`currency`	`string`	optional	Currency Example: {}
`unit`	`string`	optional	unit Example: {}
`quantityBegin`	`integer`	optional	Minimum batch size Example: {}
`quantityPrices`	`string`	optional	price range Example: {}
`salesOrderCount`	`integer`	optional	The number of sales, returns the corresponding value according to the statistical period Example: {}
`salesQuantity`	`integer`	optional	The number of pieces sold, returns the corresponding value according to the statistical period Example: {}
`estimatedSalesAmount`	`integer`	optional	Estimated sales, returning corresponding values according to statistical period Example: {}
`dataType`	`string`	optional	Data type: `weeklyData` weekly data, `monthlyData` monthly data Example: {}
`availableDate`	`string`	optional	Product shelf time, in the format of `yyyy-MM-dd HH:mm:ss` Example: {}
`deliveryTime`	`string`	optional	Shipping time Example: {}
`levelName`	`string`	optional	Category level name Example: {}
`company`	`string`	optional	Store name Example: {}
`shopId`	`string`	optional	Store ID Example: {}
`shopUrl`	`string`	optional	Store link address Example: {}
`asinUrl`	`string`	optional	Product link address Example: {}
`imageUrl`	`string`	optional	Image address Example: {}
`sourceType`	`string`	optional	Source platform (1688) Example: {}

Examples

Example arguments

{
  "date": "2026-03-01",
  "keyWord": "phone case",
  "pageIndex": 1,
  "pageSize": 20,
  "pageType": 3,
  "sortField": "orderCount",
  "sortType": "desc"
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}