POST
https://api.nexscope.ai/gb/temu/mallSearchRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/gb/temu/mallSearch |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
regionId | integer | optional | Temu region ID, taken from site list `sites[].regionId` |
page | integer | optional | Page number |
size | integer | optional | Quantity per page; `page * size` must not exceed 10000 |
keyword | string | optional | Match store name keywords |
catIds | integer[] | optional | Category ID array; elements taken from `categories[].catId` |
hostingMode | integer | optional | `1`=fully managed, `2`=semi-managed |
sort | string | optional | Sorting fields; only use the interface to confirm supported fields |
order | string | optional | Sorting direction, case-insensitive |
Code example
{
"mallStarMin": 4,
"page": 1,
"regionId": 211,
"size": 20
}Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "-1",
"data": {},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Response fields
Response field reference (17 fields)
| Name | Type | Required | Description |
|---|---|---|---|
items | array | optional | Store on the current page; the business field may be missing or `null` |
columns | array | optional | Render column definition |
total | integer | optional | Total number of hits reported by upstream; service limits accessible window `page * size <= 10000` |
page | integer | optional | Current page number |
size | integer | optional | Quantity per page |
regionId | integer | optional | The region ID used in this request |
title | string | optional | `Temu data query` |
sourceType | string | optional | `temu` |
type | string | optional | `tableListWorkbenches` |
sites | array | optional | Supported Temu sites |
total | integer | optional | Number of sites |
columns | array | optional | Render column definition |
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. |
categories | array | optional | Specify the category node under the parent level |
total | integer | optional | Return the number of nodes |
parentCatId | integer / omitted | optional | The parent ID of this query; may be omitted in first-level queries |
columns | array | optional | Render column definition |
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.