POST
https://api.nexscope.ai/api/skill-api/v1/skills/geekbi-temu-goods-image-search/runRun 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-image-search/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
imageUrl | string | required | Provider OSS temporary image URL, obtained through presignedPut and a successful PUT upload with the signature query removed. Replace the example.invalid placeholder before calling; external URLs are rejected upstream. Actual image must be at most 10 MB and JPEG, PNG, GIF, WebP or BMP. Example: https://example.invalid/replace-with-provider-oss-image |
contentType | string | optional | Must match OSS response and actual image bytes; omitted means server detection. Example: image/jpeg |
Request example
{
"imageUrl": "https://example.invalid/replace-with-provider-oss-image",
"contentType": "image/jpeg"
}Response body
| 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 | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
Any of option 1
| 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. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"data": {
"columns": [],
"items": [],
"total": 0
},
"code": 0,
"msg": "ok",
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}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.