linkfox-temu-product-query

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Temu 商品查询

Temu Product Query

要点

Key Points

分页：
```
page
```
从 1 起；
```
pageSize
```
默认 20、最大 100（建议 ≤50）。
区间入参：
```
*Begin
```
/
```
*End
```
成对出现（价格、评分、评论、总/周/日销量、上架时间），组成上游区间。
类目：
```
categoryHome
```
前台类目 ID、
```
categoryBackend
```
后台类目 ID；可先用 Temu 品类检索拿到 id。
托管模式：
```
isLocal
```
（0=全托管，1=半托管）；半托管可用
```
region
```
限定地区（多个逗号分隔）。
上下架：
```
soldOut
```
（0=上架，1=下架）。
标签：
```
tags
```
/
```
customTags
```
多个用逗号分隔。
排序：
```
sortBy
```
为「字段-方向」字符串，如
```
order_week-0
```
（周销量降序，默认）、
```
price-0
```
、
```
order_total-0
```
、
```
rating-0
```
。

Pagination:
```
page
```
starts from 1;
```
pageSize
```
defaults to 20, maximum 100 (recommended ≤50).
Range Parameters:
```
*Begin
```
/
```
*End
```
appear in pairs (price, rating, reviews, total/weekly/daily sales, listing time) to form upstream ranges.
Categories:
```
categoryHome
```
is the front-end category ID,
```
categoryBackend
```
is the back-end category ID; you can first get the IDs via Temu category search.
Managed Mode:
```
isLocal
```
(0 = fully managed, 1 = semi-managed); for semi-managed,
```
region
```
can be used to limit regions (multiple separated by commas).
Listing Status:
```
soldOut
```
(0 = listed, 1 = sold out/off-shelved).
Tags:
```
tags
```
/
```
customTags
```
with multiple values separated by commas.
Sorting:
```
sortBy
```
is a string in the format of "field-direction", such as
```
order_week-0
```
(weekly sales descending, default),
```
price-0
```
,
```
order_total-0
```
,
```
rating-0
```
.

脚本（可选）

Script (Optional)

命令行调试：

python scripts/temu_product_query.py '<JSON>'

（需

LINKFOXAGENT_API_KEY

）。详见 references/api.md 末尾。

Command line debugging:

python scripts/temu_product_query.py '<JSON>'

(requires

LINKFOXAGENT_API_KEY

). See the end of references/api.md for details.

参考

References

入参/出参表见 references/api.md。

The parameter input/output table can be found in references/api.md.

解决认证和积分问题

Resolve Authentication and Points Issues

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

When the following exceptions occur, guide users to resolve them using references/onboarding.md:

异常情况

Exception Scenarios

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

API Key Not Configured: The environment variable
```
LINKFOX_AGENT_API_KEY
```
or
```
LINKFOXAGENT_API_KEY
```
is not configured.
Response with 401 or 402 Status Code
Response Indicates Insufficient Points or Balance: The message contains "insufficient points balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/needs recharge/please recharge" or similar meanings.

积分消耗规则

Points Consumption Rules

按动态规则计费：消耗积分 = 产品数量 × 1.8。按本页返回条数计费；翻到下一页，本质上是再发一次请求，再按下一页返回条数重新计算。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

Billed by dynamic rules: Points consumed = number of products × 1.8. Billed based on the number of items returned on this page; turning to the next page is essentially sending another request, and the points are recalculated based on the number of items returned on the next page.

Important: The service of this skill is calculated dynamically by multiples, which may consume a large number of points at one time. Users must be reminded and decide whether to continue.