Finewisdom API Hub
首页 › 数据接口 › 1688 › item_search_1688

1688商品搜索接口item_search_1688

item_search_1688 是 Finewisdom 的1688商品搜索接口:按关键词搜索1688商品。单价 ¥0.2 / 次,成功才计费,注册赠 20 次。

注册领 20 次免费额度catalog.jsonMCP

参数

参数说明约束
keyword关键词必填
page页码可选

调用示例

把 token 换成你的即可,所有参数走 query string。

GET https://finewisdom.top/api?token=fw_xxx&method=item_search_1688&keyword=关键词&page=页码

Python 调用

import requests

resp = requests.get(
    "https://finewisdom.top/api",
    params={"token": "fw_xxx", "method": "item_search_1688", "keyword": "...", "page": "..."},
    timeout=60,
)
payload = resp.json()
if payload.get("status") == "success":
    data = payload["data"]
else:
    print(payload["message"])  # 失败不计费

返回结构

统一信封。status 为 success 才计费,失败 / 空结果不扣费。

{
  "status": "success",
  "message": "...",
  "data": { ... }
}

示例只展示统一信封,data 内字段以实际返回为准——建议先用 1 次调用看结构,再写解析。

Token 在控制台注册后自动生成,形如 fw_xxx,不要写进代码仓库或日志。

计费与限流

单价 ¥0.2 / 次,只在 status=success 时扣费;失败、超时、空结果都不计费。限流 1 次/秒/IP,超出返回 429。

新用户注册赠 20 次免费调用,余额不过期。

常见问题

这个接口调用失败会扣钱吗?

不会。返回 status=error 或 api_error 时不计费,预扣的额度会自动退回。只有当 status=success 才算一次成功调用。

单价多少,怎么计费?

¥0.2 / 次,按成功调用次数计费,没有月费、没有最低消费。翻页每翻一页各算一次调用。

同平台其他接口

item_get_1688¥0.2获取1688商品详情item_get_company_1688¥0.2获取1688商家信息item_review_1688¥0.2获取1688商品评论item_search_img_1688¥0.2通过图片搜索1688商品