POSThttps://api.nexscope.ai/api/skill-api/v1/skills/geekbi-temu-goods-search/run

Run this API

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

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/api/skill-api/v1/skills/geekbi-temu-goods-search/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

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`

Code example

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

Response example

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

{
  "data": {
    "columns": [],
    "items": [],
    "total": 0,
    "regionId": 211,
    "page": 1,
    "size": 3
  },
  "code": 0,
  "msg": "ok",
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Response fields

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

Responses

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

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.

Name

Type

Required

Description

data

object

required

Data value used by this API operation.

data.columns

array | null

optional

Render column definitions; business records are separate.

data.columns[]

any

required

Item in data columns.

data.title

string | null

optional

Provider render/source metadata: title.

data.type

string | null

optional

Provider render/source metadata: type.

data.sourceTool

string | null

optional

Provider render/source metadata: sourceTool.

data.sourceType

string | null

optional

Provider render/source metadata: sourceType.

data.items

array | null

optional

Returned records, including valid empty results; preserve duplicate records and unknown fields.

data.items[]

object

required

Item in data items.

data.items[].isAd

boolean | null

optional

Provider product flag: isAd.

data.items[].isCustom

boolean | null

optional

Provider product flag: isCustom.

data.items[].isPresale

boolean | null

optional

Provider product flag: isPresale.

data.items[].goodsId

string | null

optional

Provider goodsId; preserve identifier and timestamp strings.

data.items[].mallId

string | null

optional

Provider mallId; preserve identifier and timestamp strings.

data.items[].thumbnail

string | null

optional

Provider thumbnail; preserve identifier and timestamp strings.

data.items[].goodsName

string | null

optional

Provider goodsName; preserve identifier and timestamp strings.

data.items[].goodsNameCn

string | null

optional

Provider goodsNameCn; preserve identifier and timestamp strings.

data.items[].goodsNameEn

string | null

optional

Provider goodsNameEn; preserve identifier and timestamp strings.

data.items[].brand

string | null

optional

Provider brand; preserve identifier and timestamp strings.

data.items[].sku

string | null

optional

Provider sku; preserve identifier and timestamp strings.

data.items[].onSaleTime

string | null

optional

Provider onSaleTime; preserve identifier and timestamp strings.

data.items[].mallOpenTime

string | null

optional

Provider mallOpenTime; preserve identifier and timestamp strings.

data.items[].createTime

string | null

optional

Provider createTime; preserve identifier and timestamp strings.

data.items[].updateTime

string | null

optional

Provider updateTime; preserve identifier and timestamp strings.

data.items[].sold

number | null

optional

Provider sold; monetary values use the selected site's currency unless identified as supply prices.

data.items[].quantity

number | null

optional

Provider quantity; monetary values use the selected site's currency unless identified as supply prices.

data.items[].mallSold

number | null

optional

Provider mallSold; monetary values use the selected site's currency unless identified as supply prices.

data.items[].sales

number | null

optional

Provider sales; monetary values use the selected site's currency unless identified as supply prices.

data.items[].minPrice

number | null

optional

Provider minPrice; monetary values use the selected site's currency unless identified as supply prices.

data.items[].maxPrice

number | null

optional

Provider maxPrice; monetary values use the selected site's currency unless identified as supply prices.

data.items[].supplyPrice

number | null

optional

Provider supplyPrice; monetary values use the selected site's currency unless identified as supply prices.

data.items[].minSupplyPrice

number | null

optional

Provider minSupplyPrice; monetary values use the selected site's currency unless identified as supply prices.

data.items[].medianSupplyPrice

number | null

optional

Provider medianSupplyPrice; monetary values use the selected site's currency unless identified as supply prices.

data.items[].maxSupplyPrice

number | null

optional

Provider maxSupplyPrice; monetary values use the selected site's currency unless identified as supply prices.

data.items[].goodsScore

number | null

optional

Provider goodsScore; monetary values use the selected site's currency unless identified as supply prices.

data.items[].reviewNum

number | null

optional

Provider reviewNum; monetary values use the selected site's currency unless identified as supply prices.

data.items[].hostingMode

number | null

optional

Provider hostingMode; monetary values use the selected site's currency unless identified as supply prices.

data.items[].status

number | null

optional

Provider status; monetary values use the selected site's currency unless identified as supply prices.

data.items[].similarNum

number | null

optional

Provider similarNum; monetary values use the selected site's currency unless identified as supply prices.

data.items[].catIds

array | null

optional

Associated category identifiers.

data.items[].catIds[]

any

required

Item in data items[] catIds.

data.items[].catItems

array | null

optional

Category paths: catId, catName, catLevel, parentCatId and isLeaf.

data.items[].catItems[]

any

required

Item in data items[] catItems.

data.items[].daySold

number | null

optional

Provider day Sold metric; sales revenue uses site currency.

data.items[].daySoldRate

number | null

optional

Provider growth rate for day Sold.

data.items[].daySales

number | null

optional

Provider day Sales metric; sales revenue uses site currency.

data.items[].daySalesRate

number | null

optional

Provider growth rate for day Sales.

data.items[].weekSold

number | null

optional

Provider week Sold metric; sales revenue uses site currency.

data.items[].weekSoldRate

number | null

optional

Provider growth rate for week Sold.

data.items[].weekSales

number | null

optional

Provider week Sales metric; sales revenue uses site currency.

data.items[].weekSalesRate

number | null

optional

Provider growth rate for week Sales.

data.items[].monthSold

number | null

optional

Provider month Sold metric; sales revenue uses site currency.

data.items[].monthSoldRate

number | null

optional

Provider growth rate for month Sold.

data.items[].monthSales

number | null

optional

Provider month Sales metric; sales revenue uses site currency.

data.items[].monthSalesRate

number | null

optional

Provider growth rate for month Sales.

data.total

integer | null

optional

Provider match count, possibly capped at 10000 for searches.

data.regionId

integer | null

optional

Region used for the query.

data.page

integer | null

optional

Current page.

data.size

integer | null

optional

Items per page.

Name

Type

Required

Description

data

null

required

Data value used by this API operation.

Temu Product Search

What this API does

Temu Product Search

What this API does

Authentication

Run an API

Example request

Check the response

HTTP status codes

Run this API

Endpoint

Request parameters

Code example

Response example

Response fields

Responses

Data source, freshness, and limitations

MCP

Call a tool

Legacy MCP v1

Online test

Try it

Related APIs

Any of option 1

Any of option 2