Finewisdom API Hub
首页 › 数据接口 › 淘宝 › taobao_shop_search

淘宝店铺搜索接口taobao_shop_search

taobao_shop_search 是 Finewisdom 的淘宝店铺搜索接口:搜索淘宝店铺商品列表(page 1~35 约 60 条/页,支持店铺名/店铺链接/卖家ID)。单价 ¥0.1 / 次,成功才计费,注册赠 20 次。

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

参数

参数说明约束
seller_id卖家ID(与 shop_id、shop_name 至少提供一个)可选
page页码(1~35,约 60 条/页,默认 1)可选
shop_id店铺ID(数字ID或店铺链接)可选
shop_name店铺名称(如:三只松鼠官方旗舰店)可选

调用示例

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

GET https://finewisdom.top/api?token=fw_xxx&method=taobao_shop_search&seller_id=卖家ID(与shop_id、shop_name至少提供一个)&page=页码(1~35,约60条/页,默认1)&shop_id=店铺ID(数字ID或店铺链接)&shop_name=店铺名称(如:三只松鼠官方旗舰店)

Python 调用

import requests

resp = requests.get(
    "https://finewisdom.top/api",
    params={"token": "fw_xxx", "method": "taobao_shop_search", "seller_id": "...", "page": "...", "shop_id": "...", "shop_name": "..."},
    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.1 / 次,只在 status=success 时扣费;失败、超时、空结果都不计费。限流 1 次/秒/IP,超出返回 429。

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

常见问题

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

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

单价多少,怎么计费?

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

同平台其他接口

taobao_comments¥0.2获取淘宝商品评论列表taobao_item_get¥0.1获取淘宝商品详情信息taobao_original_detail¥0.1获取淘宝券前详情(不含券后价、券面额、佣金等,建议只用来获取标题图片等信息)