搜索词里写进实际用途

假设你要给狭窄玄关找一个收纳架,先测量可用空间,再用物品类型与用途组成 keyword。商品搜索提供候选入口,不会替你测量房间,也不保证结果都满足尺寸限制。先写下不能妥协的条件,例如宽度范围与承重需求,才能判断哪些条目值得继续查看。

保持检索过程可以回看

page 从一开始,翻页时保留首次返回的 search_id,source 按参数说明填写。改变关键词后把它视为新的搜索,不把两组结果混成相同条件的对比。对候选商品查看实际详情与当前信息,不能根据一张图片猜材质,也不能把搜索时看到的描述视为永久有效的规格或价格。

用自己的需求表排除不合适选项

自己的比较表可包含来源、待确认尺寸、安装方式和不适合的原因。假设某个架子需要固定到墙面,而租约不允许打孔,就应先排除,不因图片好看降低条件。接口并不验证商家履约、库存或商品质量,购买前仍需在交易页面核实。最终成果是一份有理由的短名单,而不是声称平台已经为你挑出最优商品,也不应以搜索位置替代对实际需求的判断。

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/xiaohongshu/app_v2/search_products

参数 类型 必填 含义
keyword string 是 搜索关键词
page integer 否 页码,从1开始
search_id string 否 搜索ID,翻页时传入首次搜索返回的值
source string 否 来源

可以复制的 Python 请求

安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。

import os
import requests

# 使用自己的 TRMesh 开发者密钥;不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/xiaohongshu/app_v2/search_products"
params = {
    "keyword": "手机壳",
    "page": "1",
    "source": "explore_feed"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # 先核对真实响应,再提取业务字段

对应接口文档 · 返回免费查询工具

调用接口会使用你的 TRMesh 账号额度,运行前请确认接口价格。