Temu Intelligence GB

Temu Product Search

Search Temu products for competitor and assortment research. Call the Temu Product Search API via REST or MCP from 32 credits per call.

MCP tool name

nexscope_geekbi_temu_goods_search

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": "geekbi-temu-goods-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_geekbi_temu_goods_search",
    "arguments": {
      "keyword": "dress",
      "page": 1,
      "regionId": 211,
      "size": 3
    }
  }
}

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
`regionId`	`integer`	optional	Temu region from sites[].regionId; never siteId. Example: 211
`page`	`integer`	optional	Page number. Example: 1
`size`	`integer`	optional	Items per page; page times size must not exceed 10000. Example: 3
`keyword`	`string`	optional	User keyword; preserve the supplied language. Example: dress
`sort`	`string`	optional	Confirmed provider sort field; omit when unnecessary. Example: {}
`order`	`string`	optional	Sort direction, case-insensitive. Example: {}
`catIds`	`array`	optional	Category identifiers obtained from category lookup. Example: {}
`matchMode`	`integer`	optional	1 strict matching, 2 fuzzy matching. Example: 2
`status`	`array`	optional	1 normal, 2 out of stock, 3 delisted. Example: {}
`hostingMode`	`integer`	optional	1 fully managed, 2 semi-managed. Example: {}
`soldMin`	`integer`	optional	Lower bound for sold; minimum must not exceed maximum. Example: {}
`soldMax`	`integer`	optional	Upper bound for sold; minimum must not exceed maximum. Example: {}
`daySoldMin`	`integer`	optional	Lower bound for daySold; minimum must not exceed maximum. Example: {}
`daySoldMax`	`integer`	optional	Upper bound for daySold; minimum must not exceed maximum. Example: {}
`weekSoldMin`	`integer`	optional	Lower bound for weekSold; minimum must not exceed maximum. Example: {}
`weekSoldMax`	`integer`	optional	Upper bound for weekSold; minimum must not exceed maximum. Example: {}
`monthSoldMin`	`integer`	optional	Lower bound for monthSold; minimum must not exceed maximum. Example: {}
`monthSoldMax`	`integer`	optional	Upper bound for monthSold; minimum must not exceed maximum. Example: {}
`quantityMin`	`integer`	optional	Lower bound for quantity; minimum must not exceed maximum. Example: {}
`quantityMax`	`integer`	optional	Upper bound for quantity; minimum must not exceed maximum. Example: {}
`mallSoldMin`	`integer`	optional	Lower bound for mallSold; minimum must not exceed maximum. Example: {}
`mallSoldMax`	`integer`	optional	Upper bound for mallSold; minimum must not exceed maximum. Example: {}
`reviewNumMin`	`integer`	optional	Lower bound for reviewNum; minimum must not exceed maximum. Example: {}
`reviewNumMax`	`integer`	optional	Upper bound for reviewNum; minimum must not exceed maximum. Example: {}
`salesMin`	`number`	optional	Lower bound for sales; minimum must not exceed maximum. Example: {}
`salesMax`	`number`	optional	Upper bound for sales; minimum must not exceed maximum. Example: {}
`daySalesMin`	`number`	optional	Lower bound for daySales; minimum must not exceed maximum. Example: {}
`daySalesMax`	`number`	optional	Upper bound for daySales; minimum must not exceed maximum. Example: {}
`weekSalesMin`	`number`	optional	Lower bound for weekSales; minimum must not exceed maximum. Example: {}
`weekSalesMax`	`number`	optional	Upper bound for weekSales; minimum must not exceed maximum. Example: {}
`monthSalesMin`	`number`	optional	Lower bound for monthSales; minimum must not exceed maximum. Example: {}
`monthSalesMax`	`number`	optional	Upper bound for monthSales; minimum must not exceed maximum. Example: {}
`priceMin`	`number`	optional	Lower bound for price; minimum must not exceed maximum. Example: {}
`priceMax`	`number`	optional	Upper bound for price; minimum must not exceed maximum. Example: {}
`supplyPriceMin`	`number`	optional	Lower bound for supplyPrice; minimum must not exceed maximum. Example: {}
`supplyPriceMax`	`number`	optional	Upper bound for supplyPrice; minimum must not exceed maximum. Example: {}
`daySoldRateMin`	`number`	optional	Lower bound for daySoldRate; minimum must not exceed maximum. Example: {}
`daySoldRateMax`	`number`	optional	Upper bound for daySoldRate; minimum must not exceed maximum. Example: {}
`weekSoldRateMin`	`number`	optional	Lower bound for weekSoldRate; minimum must not exceed maximum. Example: {}
`weekSoldRateMax`	`number`	optional	Upper bound for weekSoldRate; minimum must not exceed maximum. Example: {}
`monthSoldRateMin`	`number`	optional	Lower bound for monthSoldRate; minimum must not exceed maximum. Example: {}
`monthSoldRateMax`	`number`	optional	Upper bound for monthSoldRate; minimum must not exceed maximum. Example: {}
`daySalesRateMin`	`number`	optional	Lower bound for daySalesRate; minimum must not exceed maximum. Example: {}
`daySalesRateMax`	`number`	optional	Upper bound for daySalesRate; minimum must not exceed maximum. Example: {}
`weekSalesRateMin`	`number`	optional	Lower bound for weekSalesRate; minimum must not exceed maximum. Example: {}
`weekSalesRateMax`	`number`	optional	Upper bound for weekSalesRate; minimum must not exceed maximum. Example: {}
`monthSalesRateMin`	`number`	optional	Lower bound for monthSalesRate; minimum must not exceed maximum. Example: {}
`monthSalesRateMax`	`number`	optional	Upper bound for monthSalesRate; minimum must not exceed maximum. Example: {}
`goodsScoreMin`	`number`	optional	Lower bound for goodsScore; minimum must not exceed maximum. Example: {}
`goodsScoreMax`	`number`	optional	Upper bound for goodsScore; minimum must not exceed maximum. Example: {}
`onSaleTimeMin`	`string`	optional	Earliest onSaleTime in ISO-8601 date-time; minimum must not exceed maximum. Example: {}
`onSaleTimeMax`	`string`	optional	Latest onSaleTime in ISO-8601 date-time; minimum must not exceed maximum. Example: {}
`mallOpenTimeMin`	`string`	optional	Earliest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum. Example: {}
`mallOpenTimeMax`	`string`	optional	Latest mallOpenTime in ISO-8601 date-time; minimum must not exceed maximum. Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`items`	`array`	optional	Products on the current page; the business field may be missing or `null` Example: {}
`columns`	`array`	optional	Render column definition Example: {}
`total`	`integer`	optional	Total number of hits reported by upstream; service limits accessible window `page * size <= 10000` Example: {}
`page`	`integer`	optional	Current page number Example: {}
`size`	`integer`	optional	Quantity per page Example: {}
`regionId`	`integer`	optional	The region ID used in this request Example: {}
`title`	`string`	optional	`Temu data query` Example: {}
`sourceType`	`string`	optional	`temu` Example: {}
`type`	`string`	optional	`tableListWorkbenches` Example: {}
`sites`	`array`	optional	Supported Temu sites Example: {}
`total`	`integer`	optional	Number of sites Example: {}
`columns`	`array`	optional	Render column definition Example: {}
`parentCatId`	`integer`	optional	If not passed, the first-level category will be returned; if a certain `categories[].catId` is passed, its next-level category will be queried. Example: {}
`categories`	`array`	optional	Specify the category node under the parent level Example: {}
`total`	`integer`	optional	Return the number of nodes Example: {}
`parentCatId`	`integer / omitted`	optional	The parent ID of this query; may be omitted in first-level queries Example: {}
`columns`	`array`	optional	Render column definition Example: {}
`goodsId`	`string`	optional	Temu item ID, usually from searching `items[].goodsId` Example: {}
`regionId`	`integer`	optional	Temu region ID, it is recommended to use the same value as the search Example: {}
`goods`	`object`	optional	Product object, fields are the same as search `items[]` Example: {}
`history`	`array`	optional	Last 30 days history Example: {}
`regionId`	`integer`	optional	The region ID used in this request Example: {}
`title`	`string`	optional	`Temu product details` Example: {}
`sourceType`	`string`	optional	`temu` Example: {}
`type`	`string`	optional	`productWorkbenches` Example: {}
`columns`	`array`	optional	Product details rendering column Example: {}

Examples

Example arguments

{
  "keyword": "dress",
  "page": 1,
  "regionId": 211,
  "size": 3
}

Example structuredContent

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