API data site

利润算得准才敢爆单！Open Claw 1688 运费查询 API，精准核算成本 + 一键下单付款（附 Python 源码）

Mon, 27 Apr 2026 15:14:47 +0800

做电商、无货源、跨境、店群的朋友都懂：1688 拿货，运费直接决定利润。价格看着低，一加上运费就亏本；不同地区、不同数量运费差异巨大；手动算运费慢、不准、还容易漏算，最后卖得越多亏得越惨。

用 Open Claw 1688.item_fee 运费查询 API，实时获取精准运费，结合订单创建 + 付款接口，实现选品→算运费→算利润→创建订单→付款全流程自动化，彻底告别利润算错、下单繁琐、采购低效。

文章附带完整可复制 Python 代码，替换 Key 直接运行，新手也能 5 分钟上手！

一、为什么必须用 API 算运费 + 自动化下单？

手动算运费、手动下单的痛点：

运费算不准：地区、重量、数量不同，价格千差万别
利润算不清：拿货价 + 运费 + 包装 + 平台扣点，经常算错
下单效率低：多店铺、多商品、多地址，重复操作到崩溃
无法批量：批量采购、批量下单完全靠人工
数据不闭环：算运费、下单、付款割裂，容易出错漏单

**Open Claw 运费 + 订单 + 付款接口组合优势：**✅ 实时精准运费：按商品、地区、数量获取 1688 官方真实运费✅ 利润一键核算：拿货价 + 运费自动计算，利润一目了然✅ 支持创建订单：直接通过接口生成采购单，不用登网页✅ 支持付款接口：订单后快速付款，流程闭环✅ 稳定合规：不爬虫、不反爬、长期可用，适配平台更新

二、接口核心能力（直接对接业务）

本次用到 3 个核心接口，形成采购闭环：

1688.item_fee 运费查询 API（本文核心）

按商品 ID、收货地、购买数量，查询真实运费

1688.order_create 订单创建 API

自动创建 1688 采购订单，无需人工操作

1688.pay 付款 API

订单创建后，快速完成付款，流程闭环

1688.item_fee 必传参数

key / secret：调用凭证；获取测试key
num_iid：商品 ID
area：地区（省 / 市）
quantity：购买数量

运费接口必拿字段

delivery_type：配送方式
carriage：运费金额
free_carriage：是否包邮
weight：商品重量
area：配送地区
price：商品单价有了这些，成本 = 单价 × 数量 + 运费，利润秒算。

三、完整 Python 代码｜直接复制运行

代码实现：查运费→算利润→创建订单→付款一体化流程，替换 Key 即可跑。

python

运行

# -*- coding: utf-8 -*-
"""
Open Claw 1688运费查询+订单创建+付款一体化工具
功能：实时查运费、精准算利润、自动创建订单、快速付款
适合：电商采购、无货源、跨境、店群批量下单
复制即可运行，新手友好
"""
import requests

# ====================== 配置区（改成你自己的） ======================
API_KEY = "你自己的API_KEY"
API_SECRET = "你自己的API_SECRET"
# 商品ID
ITEM_ID = "702356889901"
# 采购数量
QUANTITY = 10
# 收货地区
AREA = "广东省 深圳市"
# 收货信息（订单创建用）
RECEIVE_NAME = "张先生"
RECEIVE_PHONE = "13800138000"
RECEIVE_ADDRESS = "深圳市南山区科技园"
# ====================================================================

# 接口地址
FEE_API_URL = "https://api-gw.onebound.cn/1688/item_fee"       # 运费查询
ORDER_API_URL = "https://api-gw.onebound.cn/1688/order_create" # 创建订单
PAY_API_URL = "https://api-gw.onebound.cn/1688/pay"             # 付款

# 1. 查询运费
def get_item_fee(num_iid, area, quantity):
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "num_iid": num_iid,
        "area": area,
        "quantity": quantity,
        "result_type": "jsonu"
    }
    try:
        resp = requests.get(FEE_API_URL, params=params, timeout=10)
        return resp.json()
    except Exception as e:
        print("运费查询异常：", e)
        return {}

# 2. 创建订单
def create_order(num_iid, quantity, receive_info):
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "num_iid": num_iid,
        "quantity": quantity,
        "receiver_name": receive_info["name"],
        "receiver_phone": receive_info["phone"],
        "receiver_address": receive_info["address"],
        "result_type": "jsonu"
    }
    try:
        resp = requests.get(ORDER_API_URL, params=params, timeout=15)
        return resp.json()
    except Exception as e:
        print("创建订单异常：", e)
        return {}

# 3. 订单付款
def pay_order(order_id):
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "order_id": order_id,
        "result_type": "jsonu"
    }
    try:
        resp = requests.get(PAY_API_URL, params=params, timeout=15)
        return resp.json()
    except Exception as e:
        print("付款异常：", e)
        return {}

# 展示成本利润+执行流程
def run_flow():
    print("===== Open Claw 1688运费+订单+付款一体化工具 =====")
    # 1. 获取运费
    fee_data = get_item_fee(ITEM_ID, AREA, QUANTITY)
    if not fee_data:
        return
    fee = fee_data.get("carriage", 0)
    price = fee_data.get("price", 0)
    is_free = fee_data.get("free_carriage", False)

    total_cost = float(price) * QUANTITY + float(fee)
    print("\n==================== 运费&成本核算 ====================")
    print(f"商品ID：{ITEM_ID}")
    print(f"单价：{price} 元")
    print(f"采购数量：{QUANTITY} 件")
    print(f"运费：{fee} 元（{'包邮' if is_free else '不包邮'}）")
    print(f"总成本：{total_cost:.2f} 元")
    print("======================================================\n")

    # 2. 创建订单
    receive_info = {
        "name": RECEIVE_NAME,
        "phone": RECEIVE_PHONE,
        "address": RECEIVE_ADDRESS
    }
    order_data = create_order(ITEM_ID, QUANTITY, receive_info)
    order_id = order_data.get("order_id", "")
    if order_id:
        print(f"✅ 订单创建成功，订单号：{order_id}")
    else:
        print("❌ 订单创建失败")
        return

    # 3. 快速付款
    pay_data = pay_order(order_id)
    if pay_data.get("code") == 0:
        print(f"✅ 付款成功，订单可发货！")
    else:
        print(f"❌ 付款失败：{pay_data.get('msg')}")

if __name__ == "__main__":
    run_flow()

使用步骤

安装依赖

plaintext

pip install requests

填写 API_KEY、API_SECRET
设置商品 ID、数量、收货信息
直接运行：查运费→算利润→创建订单→付款一键完成

四、这套工具能帮你做什么？（实战场景）

1. 精准算利润，不做亏本买卖

拿货价 + 实时运费自动算出总成本，定价有依据，卖一件赚一件。

2. 无货源 / 店群批量采购

多商品、多地区、多订单批量处理，一人能干十人的活。

3. 跨境卖家物流成本核算

精确计算国内段运费，结合国际物流，整体成本一目了然。

4. 自动化采购闭环

选品→算运费→下单→付款，全流程自动化，不用守在电脑前。

5. 供应商比价

同款商品不同店铺，运费 + 价格一起对比，选出真正最优货源。

五、为什么推荐 Open Claw？

接口稳定：长期维护，紧跟 1688 更新，不掉线
字段齐全：运费、重量、是否包邮、单价一次性返回
流程闭环：查运费 + 创建订单 + 付款全套支持，真正一站式
上手简单：Python/PHP/Java 通用，复制代码就能跑
性价比高：比人工采购、付费 ERP、代下单便宜太多

不管是个人卖家、工作室、企业采购，都能大幅降本增效。

六、写在最后

电商赚钱，核心是算得清、跑得快、控得住。Open Claw 1688 运费 API + 订单 + 付款接口，帮你实现：精准算运费→清晰算利润→自动下订单→快速完成付款。

彻底告别手动算运费、手动下单、利润算错的坑，把时间留给运营、转化、放大利润。

选品不踩雷！Open Claw 1688 商品评论 API，自动分析好评差评（附 Python 源码）

Tue, 14 Apr 2026 14:10:06 +0800

做电商、无货源、跨境、店群的朋友都懂：看评论 = 看真相。1688 商品主图再好看、价格再低，只要评论藏着质量差、发货慢、货不对板，上架必翻车、售后炸锅。

但手动翻评论太痛苦：一页页翻、一条条看、统计好评率、筛选质量问题… 效率极低还容易漏掉关键信息。

用 Open Claw 1688 商品评论 API，一键抓取商品全部评论、自动统计评分、筛选差评、分析质量问题，5 分钟搭建一个选品防坑质检工具，从源头避开垃圾货源。

文章附带完整可复制 Python 代码，替换 Key 就能跑！

一、为什么一定要用接口爬评论？

手动看评论的坑：

翻页慢，看不到历史早期真实评价
无法批量分析，只能凭感觉判断
看不到差评关键词：质量、色差、发货、破损
无法统计好评率、复购评价
容易被商家刷好评迷惑

Open Claw 评论 API 优势：✅ 一次性拿到全部评论 + 评分 + 好评率✅ 自动提取规格、购买数量、评价时间✅ 快速筛选差评、中评，提前避坑✅ 支持批量分析，选品更科学✅ 稳定不封号，不用处理反爬

二、接口核心功能（直接用）

接口名称：1688 商品评论获取 API作用：输入商品 ID，获取该商品所有用户评价、评分、好评率、追评等。

必传参数

key / secret：调用凭证
num_iid：商品 ID（必填）
page：页码（翻页爬全部评论）

选品必看关键字段

total_results：总评论数
rate_average：平均评分
good_percent：好评率
content：评论内容
starLevel：星级（1-5 星）
specInfo：购买规格（判断哪款容易差评）
gmtPublished：评论时间

三、完整 Python 代码｜直接复制运行

下面代码不用改逻辑，填入你的 Key 和商品 ID 即可运行：自动输出：评分、好评率、评论列表、筛选差评。

python

运行

# -*- coding: utf-8 -*-"""Open Claw 1688 商品评论获取工具功能：抓取评论、统计评分、筛选差评、质检选品避坑复制即可运行，新手友好"""import requests# ====================== 配置区 ======================API_KEY = "你自己的API_KEY"API_SECRET = "你自己的API_SECRET"# 要查询的1688商品IDITEM_ID = "612398037607"# 卖家昵称（从商品详情接口获取）SELLER_NICK = "浙江祥珑科技"# 页码PAGE = 1# ====================================================API_URL = "https://api-gw.onebound.cn/1688/item_review"def get_item_review(num_iid, nick, page=1):    params = {        "key": API_KEY,        "secret": API_SECRET,        "num_iid": num_iid,        "nick": nick,        "page": page,        "result_type": "jsonu"    }    try:        res = requests.get(API_URL, params=params, timeout=10)        data = res.json()        if "items" in data and "item" in data["items"]:            return data["items"]        else:            print("未获取到评论")            return None    except Exception as e:        print("请求异常：", e)        return Nonedef show_review_info(items):    if not items:        return    print("\n==================== 商品评论概览 ====================")    print(f"商品ID：{items.get('num_iid')}")    print(f"总评论数：{items.get('total_results')}")    print(f"平均评分：{items.get('rate_average')}")    print(f"好评率：{items.get('good_percent')}")    print("======================================================\n")    reviews = items.get("item", [])    bad_reviews = []    for i, review in enumerate(reviews, 1):        star = review.get("starLevel")        content = review.get("content").strip()        spec = review.get("specInfo")        time = review.get("gmtPublished")        print(f"【{star}星】{time}")        print(f"规格：{spec}")        print(f"评价：{content}\n")        # 收集1-3星差评        if star and int(star) <= 3:            bad_reviews.append({"time": time, "star": star, "content": content, "spec": spec})    # 输出差评汇总    if bad_reviews:        print("\n==================== ⚠️ 差评预警 ====================")        for bad in bad_reviews:            print(f"【{bad['star']}星】{bad['time']} | {bad['spec']}")            print(f"内容：{bad['content']}\n")    else:        print("\n✅ 暂无差评！")if __name__ == "__main__":    print("===== Open Claw 1688 商品评论分析工具 =====")    review_data = get_item_review(ITEM_ID, SELLER_NICK, PAGE)    show_review_info(review_data)

使用步骤

安装依赖

plaintext

pip install requests

填入 API_KEY / API_SECRET
填入 ITEM_ID 和 SELLER_NICK
运行，直接看到评分 + 好评率 + 差评汇总

四、这套工具能帮你做什么？（实战用途）

1. 选品质检：快速判断货源好坏

通过差评内容一眼识别：质量差、破损、货不对板、发货慢。

2. 规格分析：哪款颜色 / 型号容易差评

自动显示用户购买的规格，避开高频差评 SKU。

3. 批量选品：自动过滤低分商品

批量跑商品 ID，自动剔除 ** 评分 < 4.5、好评率 < 95%** 的垃圾款。

4. 竞品分析：抄作业前先看评价

看同行爆款的差评，优化自己的选品与文案。

5. 供应商考核：监控店铺评价稳定性

长期监控评论变化，判断供应商是否降质。

五、为什么推荐 Open Claw？

简单稳定：一条 URL 调用，长期维护更新
数据完整：评论、评分、规格、时间全部返回
上手极快：复制代码就能跑，不用爬虫基础
性价比高：比人工选品、付费工具便宜 10 倍
非常适合：无货源、跨境、抖店、小红书、拼多多卖家

六、写在最后

现在电商内卷到细节决定生死。别人还在看主图选品，你已经在用评论数据避坑。

Open Claw 1688 评论 API，帮你实现：一键查评论 → 自动筛差评 → 科学选品 → 降低售后 → 提高转化率

不用手动翻、不用猜、不用踩坑，复制代码就能拥有自己的选品质检机器人。

把时间留给运营和转化，把风险交给工具。

电商选品避坑指南！Open Claw 1688 店铺搜索 API，精准锁定优质供应商（附 Python 源码）

Mon, 13 Apr 2026 16:47:59 +0800

电商选品避坑指南！Open Claw 1688 店铺搜索 API，精准锁定优质供应商（附 Python 源码）

做电商、无货源、跨境铺货的朋友都清楚，选品先选供应商。1688 上店铺鱼龙混杂，找靠谱的源头厂家、实力经销商，比找爆款还难：手动翻店铺、查资质、看销量、比售后，耗时又容易踩坑，遇到不良供应商还会影响店铺口碑。

用Open Claw 1688 店铺搜索 API，实现关键词精准搜店、按实力 / 销量 / 回头客筛选、批量对比供应商，不用手动逛店、不用辨别资质，5 分钟搭建专属的优质货源筛选系统。

文章附带可直接复制运行的 Python 代码，替换你的调用 Key 即可使用，彻底解决找店难、选店慢的问题。

一、为什么找优质店铺，一定要用 API？

传统手动找店的痛点，相信大家都深有体会：

效率极低：翻几十页店铺，也找不到符合要求的优质货源
筛选模糊：只能看表面销量，看不到店铺真实实力、供货能力
信息不全：店铺资质、供货范围、发货时效、售后政策很难全面获取
易踩坑：遇到空壳店、倒手商，发货慢、质量差、售后无响应
无法批量对比：多家店铺同款对比，手动记录完全不现实

Open Claw 1688 店铺搜索 API的优势，刚好完美解决这些问题：✅ 精准搜店：输入关键词，直接返回 1688 全网匹配店铺，精准锁定目标货源方✅ 多维筛选：按店铺实力、销量、回头客、供货量、发货时效多维度过滤，只留优质店✅ 数据完整：店铺名称、主营、销量、回头率、供货范围、店铺链接一次性获取✅ 稳定合规：无需爬虫、不碰反爬风险，长期稳定可用，适配平台更新✅ 可批量可监控：支持多关键词批量搜店、定期监控店铺爆款变动，适配电商全场景

二、接口核心能力（直接对接业务）

接口名称：1688 店铺搜索 API核心作用：输入搜索关键词，获取 1688 平台匹配的店铺信息，支持筛选、排序，精准定位优质供应商。

必传参数

key、secret：Open Claw 调用凭证（核心配置）
q：搜索关键词（如：女装工厂、玩具供应商、家居一件代发）
page：页码（分页获取店铺数据）
sort：排序方式（_sale = 店铺销量从高到低，_rate = 回头客从高到低）
获取关键测试key和秘钥

选店必拿核心字段（直接对标选品需求）

表格

字段	含义	选店用途
shop_name	店铺名称	识别店铺主体，避免重复找店
shop_url	店铺链接	直接访问店铺，查看详情
sales	店铺总销量	判断店铺供货规模、爆款能力
turn_head	店铺回头客比例	衡量店铺口碑、复购率
strength	店铺实力等级	区分工厂、经销商、倒手商
main_business	店铺主营类目	匹配自身选品类目，精准匹配
min_order	最小起订量	适配自身采购 / 铺货规模，筛选低起订量店铺
delivery_time	发货时效	控制物流成本，避免超时效订单

这些字段完全覆盖选店 90% 核心需求，从实力、口碑到供货能力，一站式获取。

三、完整 Python 代码｜直接复制运行

下面这套代码无需修改核心逻辑，只需要填入你的调用 Key、搜索关键词，就能直接运行，自动筛选优质店铺、输出对比信息。

python

运行

# -*- coding: utf-8 -*-
"""
Open Claw 1688店铺搜索选品工具
功能：关键词搜店、按实力/销量筛选优质供应商、批量对比店铺信息
新手友好，复制粘贴即可运行
"""
import requests

# ====================== 【配置区】填写自己的信息 ======================
API_KEY = "你自己的API_KEY"
API_SECRET = "你自己的API_SECRET"
# 搜索关键词（可替换为工厂/类目/货源关键词，如“童装工厂”“数码配件供应商”）
KEYWORD = "女装工厂"
# 排序方式：_sale=销量从高到低，_rate=回头客从高到空，_price=价格从低到高
SORT_TYPE = "_sale"
# 页码（获取多页店铺数据）
PAGE = 1
# 最小起订量筛选（0为不限制，适配无货源/小单采购）
MIN_ORDER = 1
# =====================================================================

# 接口地址
API_URL = "https://api-gw.onebound.cn/1688/item_search_shop"

def search_1688_shop(keyword, page=1, sort="_sale"):
    """搜索1688优质店铺"""
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "q": keyword,
        "page": page,
        "sort": sort,
        "result_type": "jsonu",  # 中文正常显示
        "page_size": 30  # 每页获取30家店铺，可按需调整
    }

    try:
        # 发送请求获取店铺数据
        resp = requests.get(API_URL, params=params, timeout=15)
        data = resp.json()
        
        # 解析返回数据，提取店铺列表
        if "shops" in data and "shop" in data["shops"]:
            return data["shops"]["shop"]
        else:
            print("未获取到有效店铺数据，可能是关键词/页码有误或接口限流")
            return []
    except Exception as e:
        print(f"请求异常：{str(e)}")
        return []

def filter_quality_shops(shops, min_order=0):
    """筛选优质店铺：按起订量、销量、回头客综合过滤"""
    quality_shops = []
    for shop in shops:
        # 过滤条件：起订量≤设定值、有销量、回头客≥10%（可按需调整阈值）
        try:
            min_order_shop = int(shop.get("min_order", 9999))
            sales_shop = int(shop.get("sales", 0))
            turn_head_rate = float(shop.get("turn_head", "0%").replace("%", ""))
            
            if min_order_shop <= min_order and sales_shop > 0 and turn_head_rate >= 10:
                quality_shops.append(shop)
        except ValueError:
            continue  # 跳过数据异常的店铺
    return quality_shops

def show_shop_info(shops):
    """展示店铺核心信息（选品对比核心）"""
    if not shops:
        print("未筛选到符合条件的优质店铺")
        return

    print("\n==================== 1688优质店铺筛选结果 ====================")
    for index, shop in enumerate(shops, 1):
        print(f"\n----- 优质店铺 {index} -----")
        print(f"店铺名称：{shop.get('shop_name', '')}")
        print(f"店铺链接：{shop.get('shop_url', '')}")
        print(f"店铺总销量：{shop.get('sales', 0)}")
        print(f"回头客比例：{shop.get('turn_head', '0%')}")
        print(f"店铺实力：{shop.get('strength', '未知')}")
        print(f"主营类目：{shop.get('main_business', '')}")
        print(f"最小起订量：{shop.get('min_order', 0)}件")
        print(f"发货时效：{shop.get('delivery_time', '未知')}")
    print("============================================================\n")

if __name__ == "__main__":
    print("===== Open Claw 1688优质店铺搜索工具 =====")
    
    # 1. 搜索1688匹配店铺
    all_shops = search_1688_shop(KEYWORD, PAGE, SORT_TYPE)
    
    # 2. 展示全部搜索到的店铺
    show_shop_info(all_shops)
    
    # 3. 筛选优质店铺（核心步骤）
    quality_shops = filter_quality_shops(all_shops, MIN_ORDER)
    print(f"\n【优质店铺筛选】共找到 {len(quality_shops)} 家符合条件的优质供应商")
    show_shop_info(quality_shops)

快速使用步骤

安装依赖库：
plaintext
```
pip install requests
```
替换代码中的API_KEY和API_SECRET为你自己的调用凭证
修改搜索关键词、排序方式、起订量等配置
直接运行脚本，立刻输出优质店铺列表 + 核心对比信息

四、这套代码能做什么？（电商实战场景全覆盖）

1. 精准找工厂，拒绝倒手商

输入 “XX 类目工厂” 关键词，按店铺实力、回头客筛选，直接锁定源头厂家，拿到更低供货价，提升利润空间。

2. 无货源选店，一键找一件代发优质店

筛选低起订量、高回头客的店铺，优先选择支持一件代发的优质供应商，降低铺货风险，避免囤货压力。

3. 批量对比供应商，选最优货源

多关键词批量搜店，自动对比不同店铺的销量、起订量、发货时效，选出性价比最高的供应商，避免踩坑。

4. 店铺爆款监控，及时跟款

定期搜索店铺关键词，监控优质店铺的新品上架、销量变动，第一时间捕捉爆款货源，抢占市场先机。

5. 跨境卖家选店，匹配海外供货需求

按主营类目筛选跨境适配店铺，筛选支持跨境发货、资质齐全的店铺，适配跨境电商选品需求。

五、为什么推荐 Open Claw？

市面上找店工具要么收费高、要么数据不准、要么功能单一，而 Open Claw 店铺搜索 API 的优势很突出：

调用简单：一行 URL 调用，支持 Python/PHP/Java/JS 等多语言，新手也能快速上手
数据真实：店铺销量、回头客、实力等级等数据均为 1688 官方同步，真实可靠
筛选灵活：支持多维度组合筛选，精准匹配自身选品需求
稳定长期：专业团队维护，适配 1688 平台规则更新，不用反复改代码
性价比拉满：比雇佣人工找店、买付费选店工具成本低 10 倍，个人 / 小团队也能轻松使用

不管是个人创业者、无货源店群、跨境卖家、电商工作室，都能通过这套工具快速找到优质供应商，降低选品风险。

六、写在最后

电商选品的核心，一半是选品，一半是选供应商。找对优质店铺，才能拿到稳定的货源、合理的价格、可靠的售后，这是店铺长期盈利的基础。

Open Claw 1688 店铺搜索 API，真正做到了关键词搜店 → 多维筛选 → 优质店铺对比 → 货源对接全流程自动化。

不用手动翻页、不用辨别资质、不用对比数据，复制代码就能搭建自己的优质供应商筛选系统。

把时间从找店、踩坑的重复劳动中解放出来，专注选品、运营、转化，这才是电商赚钱的核心逻辑

电商选品效率革命！Open Claw 1688 关键词搜索 API，全自动批量选品监控（附 Python 源码）

Thu, 09 Apr 2026 15:32:41 +0800

做 1688 铺货、无货源、跨境、抖店的朋友都清楚，关键词选品是每天最耗时的环节：手动搜词、翻页筛选、记录价格销量、过滤低质货源…… 重复劳动多，效率极低，还容易错过爆款。

今天给大家带来一套完整教程：用Open Claw 1688 关键词搜索 API，实现关键词一键搜款、批量筛选、销量排序、价格区间过滤、自动选品，不用反爬、不用人工翻页，5 分钟搭建属于自己的选品引擎。

文章附带可直接复制运行的 Python 代码，替换 Key 即可使用。

一、为什么用 API 做关键词选品？

传统手动选品的痛点：

翻页慢，一天筛选不了多少商品
无法批量、无法自动化，数据滞后
不能按价格 / 销量 / 地区精准过滤
容易遇到验证码、IP 限制、页面加载卡顿
无法长期监控市场爆款变化

Open Claw 关键词搜索 API优势：✅ 关键词一键搜索，秒出商品列表✅ 支持销量 / 价格 / 信用排序✅ 可设置价格区间、起订量、发货地、包邮等筛选✅ 一次性返回标题、价格、销量、地区、商品链接✅ 稳定长期运行，适合批量选品与监控

二、接口核心功能（直接用）

接口名称：1688 关键词搜索商品 API作用：输入关键词，自动获取 1688 商品列表，支持筛选与排序。

必传参数

key、secret：调用凭证
q：搜索关键词（如：女装、篮球袜、家居好物）
sort：排序（_sale 销量从高到低，_bid 价格从高到低）
page：页码
start_price、end_price：价格区间
filter：过滤包邮、48 小时发货、运费险等
获取key和秘钥

选品必写字段（直接可用）

title 商品标题
price 价格
sales 销量
num_iid 商品 ID
area 发货地
detail_url 商品链接

三、完整 Python 代码｜直接复制运行

下面代码无需修改逻辑，填入你的 Key、关键词，即可一键搜索、筛选、输出高性价比货源。

python

运行

# -*- coding: utf-8 -*-
"""
Open Claw 1688关键词搜索选品工具
功能：关键词搜款、价格筛选、销量排序、批量选品、监控爆款
复制即可运行，新手友好
"""
import requests

# ====================== 【配置区】填写自己的信息 ======================
API_KEY = "你自己的API_KEY"
API_SECRET = "你自己的API_SECRET"
# 搜索关键词
KEYWORD = "篮球袜"
# 排序：_sale=销量从高到低，_bid=价格从高到低，sale=销量从低到高
SORT_TYPE = "_sale"
# 价格区间（0为不限制）
START_PRICE = "0"
END_PRICE = "10"
# 页码
PAGE = 1
# =====================================================================

# 接口地址
API_URL = "https://api-gw.onebound.cn/1688/item_search"

def search_by_keyword(keyword, page=1, sort="_sale", start_price="0", end_price="0"):
    """关键词搜索1688商品"""
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "q": keyword,
        "page": page,
        "sort": sort,
        "start_price": start_price,
        "end_price": end_price,
        "result_type": "jsonu",  # 中文正常显示
        "page_size": 40
    }

    try:
        resp = requests.get(API_URL, params=params, timeout=10)
        data = resp.json()
        
        if "items" in data and "item" in data["items"]:
            return data["items"]["item"]
        else:
            print("未获取到商品数据")
            return []
    except Exception as e:
        print("请求异常：", str(e))
        return []

def show_goods_list(items):
    """展示商品列表信息"""
    if not items:
        print("无数据")
        return

    print("\n==================== 1688关键词搜索结果 ====================")
    for i, item in enumerate(items, 1):
        print(f"\n--- 商品 {i} ---")
        print(f"标题：{item.get('title', '')}")
        print(f"价格：{item.get('price', '')} 元")
        print(f"销量：{item.get('sales', 0)}")
        print(f"商品ID：{item.get('num_iid', '')}")
        print(f"发货地：{item.get('area', '')}")
        print(f"链接：{item.get('detail_url', '')}")
    print("============================================================\n")

def filter_high_sales(items, min_sales=1000):
    """过滤高销量商品"""
    return [item for item in items if item.get("sales", 0) >= min_sales]

if __name__ == "__main__":
    print("===== Open Claw 1688关键词选品工具 =====")
    
    # 1. 关键词搜索商品
    goods_list = search_by_keyword(
        KEYWORD,
        page=PAGE,
        sort=SORT_TYPE,
        start_price=START_PRICE,
        end_price=END_PRICE
    )

    # 2. 展示全部搜索结果
    show_goods_list(goods_list)

    # 3. 筛选高销量商品（可选）
    hot_items = filter_high_sales(goods_list, min_sales=1000)
    print(f"\n【爆款筛选】找到 {len(hot_items)} 个销量≥1000的商品")
    show_goods_list(hot_items)

使用步骤

安装依赖：

plaintext

pip install requests

替换代码中的 API_KEY、API_SECRET
修改关键词、价格、排序方式
运行脚本，立刻输出筛选后商品列表

四、这套代码能做什么？（实战场景）

1. 关键词智能选品

输入类目词 / 长尾词，自动按销量 / 价格排序，快速挖掘潜力款。

2. 无货源批量找货

过滤低价、高销量、包邮商品，直接用于上架。

3. 类目爆款监控

定期搜索关键词，自动捕捉销量飙升的新款。

4. 价格区间选品

按利润需求筛选，比如5 元以内货源，适合做福利品、直播款。

5. 多关键词批量搜款

一次配置多个关键词，自动遍历，一天选品上千款。

五、为什么推荐 Open Claw？

接入简单：一行 URL 调用，多语言支持
数据稳定：长期维护，适配 1688 更新
字段齐全：选品核心数据一次性返回
扩展性强：可做监控、导出、批量上架
成本极低：比人工、采集器、付费软件划算得多

不管是个人副业、店群工作室、跨境采购、直播选品，都能大幅提升效率。

六、写在最后

电商选品已经进入自动化、数据化时代。谁能更快、更准、更稳地找到优质货源，谁就能占据优势。

Open Claw 1688 关键词搜索 API，真正做到：关键词输入 → 自动筛选 → 批量输出 → 爆款监控。

不用写爬虫、不用处理反爬、不用手动翻页，复制代码即可搭建自己的选品机器人。

把时间留给运营、转化、赚钱，而不是重复劳动。

1688按图搜款神器！Open Claw 拍立淘API，图片一键找同款货源（附Python源码）

Fri, 03 Apr 2026 15:03:12 +0800

做电商、无货源、跨境、抖店、小红书店铺的朋友都知道，看到爆款想找1688货源是最头疼的环节：
手动搜关键词不准、翻页几十页找不到、同款比价费时、爆款跟不上节奏……

今天给大家带来一套真正落地、可直接复制运行的实战方案：
用Open Claw 1688按图搜索API（拍立淘），一张图片，一键批量找出所有同款货源，支持销量排序、价格筛选、一件代发过滤，完全替代手动搜款，效率提升100倍。

一、按图搜货源，为什么一定要用接口？

普通手动搜款的痛点：

关键词不准，搜半天找不到同款
无法批量、无法自动化，效率极低
不能按销量/价格排序，错过优质货源
无法筛选一件代发、精选货源
爆款来了反应慢，等找到已经不爆了

Open Claw 按图搜索接口优势：
✅ 图片URL直接搜，1秒出同款列表
✅ 支持销量从高到低排序，优先找爆款
✅ 自动返回价格、销量、代发、回头率
✅ 可批量、可监控、可自动化选品
✅ 稳定不封号，不用处理反爬、验证码

二、接口核心能力（直接用）

接口名称：1688 按图搜索商品（拍立淘）
作用：传入一张商品图片URL，返回1688全网同款/相似款列表

必传参数

key / secret：调用凭证
imgid：商品图片URL（支持阿里图床/网络图片）
sort：排序方式（_sale 销量从高到低）
获取key和秘钥测试

必拿关键字段（选品神器）

title：商品标题
pic_url：商品主图
price：价格
sales：销量
num_iid：商品ID
turn_head：店铺回头率
one_psale：是否一件代发
is_jxhy：是否精选货源
detail_url：商品详情页

这些字段直接满足同款筛选、比价、选款全部需求。

三、完整Python代码｜直接复制运行

下面代码无需改逻辑，填入你的key、图片地址即可运行，自动输出：同款列表、销量、价格、是否一件代发、商品链接。

# -*- coding: utf-8 -*-"""
Open Claw 1688 按图搜款（拍立淘）工具
功能：传入图片URL，一键查找同款货源、爆款、代发货源
直接复制运行，新手可用
"""import requests# ====================== 【配置信息】填写自己的 ======================API_KEY = "你自己的API_KEY"API_SECRET = "你自己的API_SECRET"# 要搜款的图片地址（可替换成任意商品图片URL）IMG_URL = "http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"# 排序：_sale=销量从高到低，bid2=价格从低到高SORT_TYPE = "_sale"# =====================================================================# 接口地址API_URL = "https://api-gw.onebound.cn/1688/item_search_img"def search_goods_by_image(img_url, sort="_sale"):
    """按图片搜索1688同款商品"""
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "imgid": img_url,
        "sort": sort,
        "result_type": "jsonu"  # 中文正常显示
    }

    try:
        resp = requests.get(API_URL, params=params, timeout=10)
        data = resp.json()
        
        if "items" in data and "item" in data["items"]:
            return data["items"]["item"]
        else:
            print("未搜索到数据或请求失败")
            return []
    except Exception as e:
        print("请求异常：", str(e))
        return []def show_same_items(items):
    """展示同款商品信息（选品核心）"""
    if not items:
        print("无商品数据")
        return

    print("\n==================== 1688 按图搜同款结果 ====================")
    for index, item in enumerate(items, 1):
        print(f"\n----- 同款 {index} -----")
        print(f"商品标题：{item.get('title', '')}")
        print(f"价格：{item.get('price', '')} 元")
        print(f"销量：{item.get('sales', 0)}")
        print(f"商品ID：{item.get('num_iid', '')}")
        print(f"回头率：{item.get('turn_head', '0%')}")
        print(f"一件代发：{'是' if item.get('one_psale') else '否'}")
        print(f"精选货源：{'是' if item.get('is_jxhy') else '否'}")
        print(f"商品链接：{item.get('detail_url', '')}")
    print("============================================================\n")def filter_onedrop_items(items):
    """筛选：只看一件代发的商品（无货源必备）"""
    return [item for item in items if item.get("one_psale") is True]if __name__ == "__main__":
    print("===== Open Claw 1688 按图搜款工具 =====")
    
    # 1. 按图片搜索同款
    same_items = search_goods_by_image(IMG_URL, SORT_TYPE)
    
    # 2. 展示全部同款
    show_same_items(same_items)
    
    # 3. 筛选一件代发（可选）
    onedrop_items = filter_onedrop_items(same_items)
    print(f"\n【筛选结果】共找到 {len(onedrop_items)} 个一件代发同款货源")
    show_same_items(onedrop_items)

使用步骤（超简单）

安装依赖：

pip install requests

替换代码里的 API_KEY、API_SECRET
把 IMG_URL 换成你要搜的商品图片链接
直接运行，立刻输出同款货源列表

四、这套代码能做什么？（实战场景）

1. 小红书/抖音/淘宝爆款 → 1688找源头

看到别人卖爆，截张图 → 丢进脚本 → 1秒找厂家。

2. 无货源店群：一键找一件代发

自动过滤非代发商品，直接输出可上架货源。

3. 比价选最优货源

按销量/价格排序，自动找出最低价、高销量、高回头率供应商。

4. 批量搜款、批量选品

准备图片列表，循环搜索，一天选1000款不是问题。

5. 爆款监控

定期按图搜索，监控是否出现更低价、更高销量同款。

五、为什么推荐 Open Claw？

接口超稳定：长期维护，适配1688更新
返回数据全：标题、价格、销量、代发一次拿到
调用简单：一行URL，支持所有语言
性价比高：比买软件、雇人工选品便宜10倍
适合个人/工作室：低成本实现自动化选品

不管你是做抖店、拼多多、淘宝、跨境、小红书，按图搜货源都是必备能力。

六、写在最后

现在电商已经进入数据化选品时代：
谁能更快找到同款、更快锁定低价、更快筛选爆款，谁就能抢占流量。

Open Claw 1688按图搜索API，真正做到：
一张图片，一键搜遍1688同款，不用关键词、不用爬虫、不用手动翻页。

复制上面代码，5分钟搭建自己的搜款神器+选品系统，把时间留给运营和转化。

电商效率神器！Open Claw对接1688接口，全自动监控选品教程（附完整源码）

Wed, 01 Apr 2026 10:31:45 +0800

做电商的朋友应该都深有体会：1688选品、价格监控、货源对比，几乎占据了每天一半的工作时间。手动翻页、复制数据、记录价格、盯库存，不仅效率低下，还特别容易出错，爆款错过了、低价漏掉了，损失真的不小。

今天直接给大家上一套可落地、可直接复制运行的实战方案——用Open Claw标准化接口对接1688平台，无需爬虫、无需处理反爬、无需搭建复杂环境，5分钟实现商品数据采集+自动监控+智能选品，不管是个人卖家、工作室、跨境采购，都能直接用。

文章全程干货，附带完整Python运行代码，复制粘贴就能跑！

一、方案优势：为什么不用爬虫，用Open Claw接口？

很多人第一反应是写爬虫爬1688，但实际坑非常多：

平台频繁反爬、验证码、IP封禁，新手根本扛不住
网页结构经常改版，代码要反复修改
数据不完整，SKU、批发价、代发价很难一次性拿全
无法稳定长期运行，监控功能更难实现

而Open Claw + 1688商品接口的优势非常明显： ✅ 稳定合规，长期可用，不碰爬虫风险
✅ 一次请求拿到标题、价格、SKU、库存、主图、销量、代发价全量数据
✅ 接口参数简单，支持所有编程语言调用
✅ 可直接做定时监控、价格预警、库存提醒、爆款筛选
✅ 个人/小团队低成本就能实现企业级选品能力

二、1688商品接口核心说明（直接用）

我们使用的是1688商品详情获取接口，支持：

单品详情查询
30天销量数据获取
代发价格/批发价获取
SKU、主图、详情图、发货地全字段返回

必传参数：

num_iid：1688商品ID（商品链接里的数字串）
key + secret：Open Claw调用凭证获取免费测试key+secret

三、完整Python代码｜直接复制运行

下面这套代码无需修改逻辑，只需要填入你的调用key和商品ID，就能直接运行，自动获取：商品标题、售价、批发价、最小起批量、发货地、库存状态。

Python 监控选品代码（可直接运行）

python# -*- coding: utf-8 -*-"""Open Claw 1688商品监控选品工具功能：获取商品详情、价格、SKU、库存、销量，可用于选品/监控/比价直接复制运行，安装依赖后即可使用"""import requestsimport jsonimport time# ====================== 【配置信息】填写自己的即可 ======================API_KEY = "你自己的API_KEY"API_SECRET = "你自己的API_SECRET"# 要监控的1688商品ID（复制商品链接里的数字即可）ITEM_ID = "702356889901"# 监控间隔（分钟），0=只运行一次MONITOR_INTERVAL = 10# =====================================================================# 接口地址API_URL = "https://api.openclaw.com/1688/item_get"def get_1688_item_info(num_iid):    """获取1688商品详细信息"""    params = {        "key": API_KEY,        "secret": API_SECRET,        "num_iid": num_iid,        "sales_data": 1,    # 获取销量数据        "agent": 1          # 获取代发价格    }    try:        response = requests.get(API_URL, params=params, timeout=15)        result = response.json()                if result.get("code") == 0:            return result.get("data", {})        else:            print("获取失败：", result.get("msg"))            return None    except Exception as e:        print("请求异常：", str(e))        return Nonedef parse_item_data(data):    """解析商品数据，输出选品核心信息"""    if not data:        return        print("\n==================== 1688商品选品信息 ====================")    print(f"商品ID：{data.get('num_iid')}")    print(f"商品标题：{data.get('title')}")    print(f"销售价格：{data.get('price')}")    print(f"批发价格：{data.get('batch_price')}")    print(f"代发价格：{data.get('agent_price')}")    print(f"最小起批量：{data.get('min_num')}")    print(f"发货地：{data.get('location')}")    print(f"库存状态：{data.get('stock_state')}")    print(f"30天销量：{data.get('sales')}")    print("========================================================\n")def monitor_price():    """监控商品价格/库存变动（可选）"""    last_price = None    while True:        data = get_1688_item_info(ITEM_ID)        if data:            current_price = data.get("price")            parse_item_data(data)                        # 价格变动提醒            if last_price and current_price != last_price:                print(f"【⚠️价格预警】价格从 {last_price} 变为 {current_price}！")                        last_price = current_price                # 等待下一次监控        print(f"\n等待 {MONITOR_INTERVAL} 分钟后重新监控...")        time.sleep(MONITOR_INTERVAL * 60)if __name__ == '__main__':    print("===== Open Claw 1688自动选品监控工具 =====")        # 模式1：单次获取商品信息（直接选品用）    item_data = get_1688_item_info(ITEM_ID)    parse_item_data(item_data)        # 模式2：自动循环监控（价格/库存监控用）    # monitor_price()

使用步骤（超简单）

安装依赖：
```
pip install requests
```
把代码里的API_KEY和API_SECRET换成你自己的
填入要监控的1688商品ID
直接运行，立刻输出商品全量选品数据

四、代码能实现什么？（选品实战用途）

这套脚本拿到数据后，你可以直接用于：

1. 快速选品分析

自动输出：价格、批发价、代发价、起批量、销量、发货地，一键判断是否值得做。

2. 价格自动监控

开启循环监控，商品降价/涨价自动提醒，不错过最佳拿货时机。

3. 批量选品筛选

准备一个商品ID列表，循环遍历，自动筛选出：

低价高利润款
低起批量适合无货源款
高销量爆款
优质发货地货源

4. 一键生成上架数据

自动导出标题、主图、SKU、价格、详情，直接用于淘宝、拼多多、抖音、跨境平台上架。

5. 供应商对比

同款商品多个ID同时监控，自动对比价格、起批量、发货速度，锁定最优货源。

五、为什么推荐Open Claw？

市面上接口工具很多，但真正适合电商卖家的很少，Open Claw的优势非常贴合实战： ✅ 接口稳定：长期维护，自动适配平台更新 ✅ 数据全：一次拿到选品所有字段，不用二次拼接 ✅ 上手简单：一行代码调用，新手也能5分钟跑通 ✅ 性价比高：比爬虫、采集器、人工统计成本低10倍以上 ✅ 支持监控：可直接做7×24小时价格/库存监控 ✅ 多语言支持：Python/PHP/Java/JS均可调用

不管是个人副业、无货源店群、跨境采购、传统电商，都能快速提升效率。

六、写在最后

现在的电商竞争，本质上是效率竞争。谁能更快找到爆款、更快锁定低价、更快监控市场，谁就能抢占先机。

Open Claw + 1688接口这套方案，真正做到了：不用爬虫、不用反爬、不用复杂开发、低成本、高稳定。

你只需要复制上面的代码，简单配置，就能拥有一套属于自己的： ✅ 自动选品工具
✅ 价格监控助手
✅ 货源对比系统
✅ 上架数据生成器

把时间从重复劳动中解放出来，专注运营、转化、赚钱，才是电商正确的打开方式。

如果觉得这套教程有用，欢迎点赞+收藏，需要批量监控、多商品管理、数据导出Excel版本，也可以直接扩展这套代码！

深耕京东评论接口4年，那些熬夜踩过的坑，新手看完少走3年弯路

Mon, 09 Feb 2026 15:36:49 +0800

做电商技术开发这么多年，对接过京东各类接口，最让人头疼的莫过于评论接口。它不像商品详情、关键字接口那样逻辑清晰、文档详尽，反而藏着太多“隐形门槛”——签名参数藏在社区沉帖里、主评追评分离存储、限流比想象中更严苛，甚至部分字段会临时变更，没有任何通知。

从第一次对接时连续10小时调试签名失败，到后来能稳定支撑日均8万次评论采集，4年间我踩过的坑不计其数，有好几次因为接口踩坑，熬夜改代码到凌晨，还被客户追责。今天就把这些血的教训、可直接复制复用的代码，以及接口不为人知的潜规则全抖出来，给做差评预警、评论分析、竞品监控的朋友避避雷，少走我当年的弯路。

返回json示例/注册免费测试

---------------------------------------
{
 "items": {
 "real_total_results": 20000,
 "total_results": 20000,
 "page_size": 10,
 "page": "1",
 "item": [
 {
 "rate_content": "香气清雅舒适，粮香明显，口感绵甜柔和，尾净回甘，性价比高，包装大气，自饮送礼都有面。",
 "rate_date": "2026-02-08 21:47:08",
 "pics": [
 "https://img30.360buyimg.com/n0/s128x96_jfs/t1/389655/32/18343/118331/698893dcFc4aa003d/00a94b064058ce49.jpg",
 "https://img30.360buyimg.com/n0/s128x96_jfs/t1/396506/19/163/150413/698893dcF48c1a330/00a94b064087616b.jpg"
 ],
 "rate_id": 103774150159104860,
 "guid": "T6NdPsBziZktdR-PWqacyHmH",
 "score": 5,
 "display_user_nick": "勿忘初心0901",
 "auction_sku": "42度 520mL 2瓶 双支装;",
 "add_feedback": ""
 },
 {
 "rate_content": "海之蓝一如既往的好喝",
 "rate_date": "2026-02-08 19:18:17",
 "pics": [
 "https://img30.360buyimg.com/n0/s128x96_jfs/t1/396042/11/2076/196681/698870f8F0fa0b2c0/00a942f5946b7280.jpg",
 "https://img30.360buyimg.com/n0/s128x96_jfs/t1/391729/36/16857/265891/698870f8F4046c3ca/00a942f59415e8ca.jpg"
 ],
 "rate_id": 104035000164778060,
 "guid": "T6NaOcRyiJwtdRyCXKGQwHmC",
 "score": 5,
 "display_user_nick": "心有所属属",
 "auction_sku": "42度 480mL 6瓶 整箱装;",
 "add_feedback": ""
 },
 {
 "rate_content": "物流速度很快，第二天就到了，包装完好，价格也很实惠，比超市还便宜一些，正好是年货，春节送人比较合适，海之蓝还是家庭型实用不错的",
 "rate_date": "2026-02-08 16:14:08",
 "pics": [
 "https://img30.360buyimg.com/n0/s128x96_jfs/t1/391719/12/18168/290843/69884390F022355fd/0015300400d2d853.jpg",
 "https://img30.360buyimg.com/n0/s128x96_jfs/t1/386871/26/22397/122938/698843c4F7c964ca9/00153004000f4025.jpg"
 ],
 "rate_id": 104024350182724940,
 "guid": "T6NaOcVzi5ktdRKEXKScyXuD",
 "score": 5,
 "display_user_nick": "浩***1",
 "auction_sku": "42度 480mL 6瓶 整箱装;",
 "add_feedback": ""
 },
 {
 "rate_content": "口感层次丰富，喝起来很顺口，值得8星推荐",
 "rate_date": "2026-02-08 09:41:07",
 "pics": [
 "https://img30.360buyimg.com/n0/s128x96_jfs/t1/391552/34/15346/106407/6987e9b3F772b8a8d/00a94374311b3d58.jpg"
 ],
 "rate_id": 103940790169777230,
 "guid": "T6NdMMN3j5UtdRyPXKGfwnyH",
 "score": 5,
 "display_user_nick": "j***o",
 "auction_sku": "42度 375mL 6瓶 整箱装;",
 "add_feedback": ""
 },
 {
 "rate_content": "朋友介绍买的，还不错的哦，口感很好，下次继续购买的",
 "rate_date": "2026-02-07 12:13:44",
 "pics": [],
 "rate_id": 104015050164818980,
 "guid": "T6NaOcZyiJktdRyCU6eQyXiA",
 "score": 5,
 "display_user_nick": "vivian_yuanyuanyuan",
 "auction_sku": "42度 520mL 2瓶 双支装;",
 "add_feedback": ""
 },
 {
 "rate_content": "............................................................",
 "rate_date": "2026-02-05 16:39:45",
 "pics": [],
 "rate_id": 103761820166766700,
 "guid": "T6NdPsF2gJ4tdRyAXKCex3-J",
 "score": 5,
 "display_user_nick": "s***t",
 "auction_sku": "42度 520mL 6瓶 整箱装;",
 "add_feedback": ""
 },
 {
 "rate_content": "不错，喝起来也很好，下次还会光顾的。",
 "rate_date": "2026-02-05 15:10:55",
 "pics": [],
 "rate_id": 104000960171741470,
 "guid": "T6NaOcd3gZotdR2HXKKZxHmG",
 "score": 5,
 "display_user_nick": "霍yt",
 "auction_sku": "42度 520mL 2瓶 双支装;",
 "add_feedback": ""
 },
 {
 "rate_content": "此用户未填写评价内容",
 "rate_date": "2026-02-03 13:06:00",
 "pics": [],
 "rate_id": 103972500171124960,
 "guid": "T6NdMMB1jZwtdR2HWqScyXmC",
 "score": 5,
 "display_user_nick": "jd_42cup6rw5snw0a",
 "auction_sku": "42度 480mL 6瓶 整箱装;",
 "add_feedback": ""
 },
 {
 "rate_content": "此用户未填写评价内容",
 "rate_date": "2026-02-03 11:30:04",
 "pics": [],
 "rate_id": 103400810159051170,
 "guid": "T6NdPcd3gJ0tdR-PW6OZwXmE",
 "score": 5,
 "display_user_nick": "jd_逆水寒",
 "auction_sku": "42度 375mL 6瓶 整箱装;",
 "add_feedback": ""
 },
 {
 "rate_content": "此用户未填写评价内容",
 "rate_date": "2026-02-03 11:29:47",
 "pics": [],
 "rate_id": 103414190153355170,
 "guid": "T6NdPcZziZUtdR-FWKOdwXmD",
 "score": 5,
 "display_user_nick": "j***寒",
 "auction_sku": "42度 520mL 2瓶 双支装;",
 "add_feedback": ""
 }
 ],
 "good_rate": 0.98,
 "page_count": 100,
 "_ddf": "fqx"
 },
 "secache": "811e7e335214d85e402519cc52cc47dc",
 "secache_time": 1770621801,
 "secache_date": "2026-02-09 15:23:21",

一、初次翻车：混淆sign生成逻辑+漏传client_type，调试到凌晨三点

第一次对接京东评论接口，是帮商家做“差评实时预警系统”，核心需求是抓取指定SKU的最新评论，一旦出现1-2分差评，立即推送通知。我刚做完京东商品详情接口，想当然地把详情接口的签名逻辑照搬过来，结果连续10小时，接口只返回两种错误：40001签名无效、40002参数错误。

翻遍京东开放平台官方文档，只看到评论接口的基础参数，关于签名的细节只字未提，最后在开发者社区一篇3年前的沉帖里，才摸清两个致命错误：

评论接口的sign生成，必须包含client_type参数，而商品详情接口不需要！这个参数是评论接口的专属必传项，漏传直接报签名错误，错误信息和“密钥错误”完全一致，新手根本无法区分；
时间戳格式踩坑：京东评论接口要求timestamp必须是10位秒级时间戳，而商品详情接口支持10位秒级和13位毫秒级，我惯性用了毫秒级时间戳，导致签名加密结果和官方校验不一致，反复调试都找不到问题。

除此之外，评论接口的method参数必须传jd.union.open.comment.get，不能用商品详情的method，哪怕其他参数全对，也会返回空数据。那天对着官方示例，逐字符对比签名计算过程，反复测试了12次，终于磨出能稳定跑通的签名函数，把所有必传参数和注意事项都标了出来：

import hashlib
import time
import urllib.parse

def generate_jd_comment_sign(params, app_secret):
    """
    京东评论接口签名生成（必传client_type+10位秒级时间戳，避坑重点！）
    :param params: 请求参数（不含sign）
    :param app_secret: 京东开放平台应用密钥
    :return: 加密后的签名（大写）
    """
    # 1. 强制添加评论接口专属必传参数，缺一个直接报错，新手最易漏传client_type
    params["client_type"] = "pc"  # 固定传pc或app，二者均可，不能省略
    params["v"] = "2.0"           # 接口版本固定2.0，漏传报40002
    params["format"] = "json"     # 固定返回格式json，不支持xml
    params["timestamp"] = str(int(time.time()))  # 必须10位秒级，毫秒级必错
    params["method"] = "jd.union.open.comment.get"  # 评论接口固定method，不能改
    
    # 2. 过滤sign参数，按参数名ASCII升序排序（京东对排序敏感，差一个字符都不行）
    sign_params = {k: v for k, v in params.items() if k != "sign" and v is not None}
    sorted_params = sorted(sign_params.items(), key=lambda x: x[0])
    
    # 3. 拼接参数为key=value&key=value格式，值需URL编码（保留-_.~，其他特殊字符转义）
    query_str = "&".join([
        f"{k}={urllib.parse.quote(str(v), safe='-_.~')}"
        for k, v in sorted_params
    ])
    
    # 4. 首尾拼接app_secret，MD5加密后转大写（和商品详情接口加密方式一致，但参数不同）
    sign_str = f"{app_secret}{query_str}{app_secret}"
    return hashlib.md5(sign_str.encode()).hexdigest().upper()

# 示例调用：抓取指定SKU的评论，page_size最大20，最多返回100页
if __name__ == "__main__":
    app_key = "your_jd_app_key"  # 替换成自己的app_key
    app_secret = "your_jd_app_secret"  # 替换成自己的app_secret
    sku_id = "1000283456789"  # 京东SKU ID，只能传SKU，不能传商品主ID
    
    params = {
        "app_key": app_key,
        "sku_id": sku_id,
        "page": 1,
        "page_size": 20,  # 单页最多20条，超了返回空数据
        # 显式指定返回字段，避免返回冗余数据，也避免漏字段
        "fields": "id,nickname,score,content,images,create_time,after_comment,user_level"
    }
    
    # 生成签名并添加到参数中
    params["sign"] = generate_jd_comment_sign(params, app_secret)
    print("请求参数准备完成，可直接发起评论接口请求")
    print("签名示例（前20位）：", params["sign"][:20])

淘宝get_item V1详情优惠字段获取

Mon, 05 Jan 2026 16:23:32 +0800

限流暴击：免费版 60 次 / 分钟，大促被封 7 天

淘宝商品详情接口的限流分 “梯度”超过限制后不是临时限流，而是直接封禁接口 7 天。有次 “双十一” 预热，我帮客户采集 500 个竞品商品，10 分钟内发了 800 次请求，结果被封到活动结束，客户损失了近 10 万销售额。

痛定思痛后，我用 “令牌桶算法 + 优先级队列” 做了限流，还加了 “失败重试 + 指数退避”，从此再也没被封过

python/测试链接

# coding:utf-8 """ Compatible for python2.x and python3.x requirement: pip install requests """ from __future__ import print_function import requests # 请求示例 url 默认请求参数已经做URL编码 url = "https://api-gw.onebound.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=652874751412&is_promotion=1" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

做了 6 年淘宝客工具，这些接口 “暗规则” 我刻在了脑子里，踩中任何一个都得熬夜改代码，新手一定要记牢：

fields 参数不能省，漏一个字段就返回空：接口默认只返回num_iid和title，价格、库存、SKU 都要显式指定，别信文档里的 “默认返回所有字段”；
reserve_price是划线价，不是原价：真实原价看original_price，划线价可随意设置，用来营销，不能作为定价依据；
库存-1是充足，不是缺货：淘宝的stock=-1代表 “库存充足，不限购”，0才是缺货，搞反了会导致超卖或下架正常商品；
SKU 解析必须用spec_id关联：规格名称可能重复（如 “颜色” 和 “色彩”），用spec_id排序后拼接，避免规格组合错误；
免费版别碰大促：60 次 / 分钟的限制在双十一、618 期间完全不够用，提前 3 个月申请企业版，否则活动期间必被封。

做京东关键字搜索系统 3 年，被接口坑到凌晨改代码的实战手记

Sun, 04 Jan 2026 15:03:10 +0800

排序陷阱：乱传sort参数，搜索结果全反了

做竞品监控时，老板要求 “按销量降序排序，抓 top30 的竞品”，我随手传了sort="sales"，结果返回的全是销量最低的商品，导致监控数据完全失效，错过了大促前的竞品调价预警。

查了半天才知道，京东关键字接口的sort参数有严格取值，销量降序是sales_desc，升序是sales_asc，传sales会默认按 “综合排序”（不是销量） ，文档里只列了部分取值，很多排序字段要靠自己试。

免费测试////

---------------------------------------
{
	"items": {
		"page": "1",
		"url": "https://search.jd.com/Search?keyword=%E5%8D%8E%E4%B8%BAmatebook14",
		"keyword": "华为matebook14",
		"real_total_results": "2994",
		"total_results": "2994",
		"page_size": 32,
		"pagecount": "100",
		"_ddf": "fqx",
		"item": [
			{
				"title": "华为MateBook 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/382678/33/10256/43516/69554e51Fd7ab6750/85328b6bcf88c700.jpg",
				"price": "6499.00",
				"sales": 40000,
				"num_iid": "100229437226",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100229437226.html",
				"reviews": 20000
			},
			{
				"title": "华为MateBook 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/380343/19/17924/43852/69554e1eF76379c58/46edb69ed8759a78.jpg",
				"price": "5799.00",
				"sales": 40000,
				"num_iid": "100176738425",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100176738425.html",
				"reviews": 20000
			},
			{
				"title": "华为MateBook GT 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/379501/27/17861/48692/69554e4aF02cf1284/4b5d85c3b5a45a86.jpg",
				"price": "7499.00",
				"sales": 5000,
				"num_iid": "100229437208",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100229437208.html",
				"reviews": 2000
			},
			{
				"title": "华为MateBook 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/384245/38/4175/46631/69554e5cF299055d6/3014c5e05e4147af.jpg",
				"price": "6499.00",
				"sales": 40000,
				"num_iid": "100229437250",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100229437250.html",
				"reviews": 20000
			},
			{
				"title": "华为MateBook 14 店铺预装Windows版 轻薄笔记本电脑 2.8K OLED触控屏 酷睿UItra5 16G 1T 深空灰",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/380602/36/18361/43917/69554e26F8ee4bc2d/81c405e963e64232.jpg",
				"price": "5799",
				"sales": 40000,
				"num_iid": "100176738429",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100176738429.html",
				"reviews": 20000
			},
			{
				"title": "华为MateBook GT 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/384672/36/3457/48692/69554e56F4d3ef5b7/6ddf97c863de8af7.jpg",
				"price": "7499.00",
				"sales": 5000,
				"num_iid": "100229437244",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100229437244.html",
				"reviews": 2000
			},
			{
				"title": "华为MateBook 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/384721/16/2968/47723/69554e21Fffe4ed2a/30acc2a287ac5c1e.jpg",
				"price": "5799.00",
				"sales": 40000,
				"num_iid": "100176738427",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100176738427.html",
				"reviews": 20000
			},
			{
				"title": "华为MateBook 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/377430/27/18977/43721/69554e54F61444d68/1ad3cd0bca535525.jpg",
				"price": "6499.00",
				"sales": 40000,
				"num_iid": "100229437230",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100229437230.html",
				"reviews": 20000
			},
			{
				"title": "华为matebook14轻薄笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/296569/14/7110/41415/68244a20F0df9402f/7e4a9d04d587cf46.png",
				"price": "2689.00",
				"sales": 10000,
				"num_iid": "10139617789126",
				"seller": "Ultrabook商务本小店",
				"shop_id": "17195504",
				"detail_url": "https://item.jd.com/10139617789126.html",
				"reviews": 5000
			},
			{
				"title": "Hi MateBook 14 酷睿Ultra 2",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/382431/16/10152/45275/6954e434Ff4575b70/4c63275976630e6f.jpg",
				"price": "6299.00",
				"sales": 2000,
				"num_iid": "100277883964",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100277883964.html",
				"reviews": 2000
			},
			{
				"title": "华为MateBook GT 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/377205/24/20233/48759/69554e1bF9735c17f/9557d674eb890b21.jpg",
				"price": "6999.00",
				"sales": 5000,
				"num_iid": "100176738411",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100176738411.html",
				"reviews": 2000
			},
			{
				"title": "华为MateBook GT 14 Linux版",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/381779/26/11326/48759/69554e4fFbc264e00/f811547142b23080.jpg",
				"price": "6999.00",
				"sales": 5000,
				"num_iid": "100229437224",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100229437224.html",
				"reviews": 2000
			},
			{
				"title": "华为MateBook 14 Ultra AI全能本",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/378535/9/20847/115120/6954c7daF8a019f97/430b9808714a86f6.jpg",
				"price": "5799.00",
				"sales": 40000,
				"num_iid": "10103759260834",
				"seller": "华为小酷克专卖店",
				"shop_id": "12049068",
				"detail_url": "https://item.jd.com/10103759260834.html",
				"reviews": 20000
			},
			{
				"title": "【政府补贴】华为笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/384509/7/6173/99564/6958e910F02ffdd79/00227e8159b038bc.jpg",
				"price": "5799.00",
				"sales": 10000,
				"num_iid": "65512219101",
				"seller": "华为比特专卖店",
				"shop_id": "796063",
				"detail_url": "https://item.jd.com/65512219101.html",
				"reviews": 10000
			},
			{
				"title": "政府补贴  华为MateBook14 25款",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/378978/4/9950/91039/694a31faF08e72a6c/9c99e58136feffa4.jpg",
				"price": "5999.00",
				"sales": 3000,
				"num_iid": "10075922710113",
				"seller": "京东电竞官方旗舰店",
				"shop_id": "10393769",
				"detail_url": "https://item.jd.com/10075922710113.html",
				"reviews": 2000
			},
			{
				"title": "Hi MateBook 14 锐龙 200系列",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/380626/30/16638/48591/6954e438F455b4505/c7b9b910c1cc49bd.jpg",
				"price": "6199.00",
				"sales": 2000,
				"num_iid": "100289708048",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100289708048.html",
				"reviews": 2000
			},
			{
				"title": "华为笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/375281/23/21236/94747/694e48b5F1930f224/087e605c5356829f.jpg",
				"price": "6499.00",
				"sales": 10000,
				"num_iid": "10103194548646",
				"seller": "华为比特专卖店",
				"shop_id": "796063",
				"detail_url": "https://item.jd.com/10103194548646.html",
				"reviews": 10000
			},
			{
				"title": "华为MateBook 14 Ultra AI全能本",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/381261/37/12748/112430/6954c7d8F0e6f576e/83cb8a96a5139cc6.jpg",
				"price": "5799.00",
				"sales": 40000,
				"num_iid": "10103759260835",
				"seller": "华为小酷克专卖店",
				"shop_id": "12049068",
				"detail_url": "https://item.jd.com/10103759260835.html",
				"reviews": 20000
			},
			{
				"title": "Hi MateBook 14 酷睿Ultra 2代",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/378063/4/18281/45205/6954e437F5e2d8f28/10b43b6dc68b4fd4.jpg",
				"price": "7499.00",
				"sales": 2000,
				"num_iid": "100277887866",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100277887866.html",
				"reviews": 2000
			},
			{
				"title": "华为matebook14轻薄笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/296569/14/7110/41415/68244a20F0df9402f/7e4a9d04d587cf46.png",
				"price": "2789.00",
				"sales": 10000,
				"num_iid": "10139617789129",
				"seller": "Ultrabook商务本小店",
				"shop_id": "17195504",
				"detail_url": "https://item.jd.com/10139617789129.html",
				"reviews": 5000
			},
			{
				"title": "Hi MateBook 14 锐龙 200系列",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/382637/30/11665/42362/6954e402F82639ff1/7a46da2ba3505da1.jpg",
				"price": "6199.00",
				"sales": 2000,
				"num_iid": "100217084277",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100217084277.html",
				"reviews": 2000
			},
			{
				"title": "【政府补贴】华为笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/381522/8/14619/98748/6958e91fFabf2426c/7095b2f69d974b59.jpg",
				"price": "5799.00",
				"sales": 10000,
				"num_iid": "10103194548644",
				"seller": "华为比特专卖店",
				"shop_id": "796063",
				"detail_url": "https://item.jd.com/10103194548644.html",
				"reviews": 10000
			},
			{
				"title": "【政府补贴】华为笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/381501/24/8495/95723/694e48beFe6ebe815/7cacb7c606c03756.jpg",
				"price": "6499.00",
				"sales": 10000,
				"num_iid": "10103194548647",
				"seller": "华为比特专卖店",
				"shop_id": "796063",
				"detail_url": "https://item.jd.com/10103194548647.html",
				"reviews": 10000
			},
			{
				"title": "【政府补贴】华为笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/375103/13/18146/94070/694e48abFdfa23d07/7e6e714fc81b787f.jpg",
				"price": "6499.00",
				"sales": 10000,
				"num_iid": "10103194548645",
				"seller": "华为比特专卖店",
				"shop_id": "796063",
				"detail_url": "https://item.jd.com/10103194548645.html",
				"reviews": 10000
			},
			{
				"title": "华为MateBook 14 Ultra AI全能本",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/385391/31/251/116863/6954c7ddF74750c83/75530f29221a732c.jpg",
				"price": "5799.00",
				"sales": 40000,
				"num_iid": "10103759260841",
				"seller": "华为小酷克专卖店",
				"shop_id": "12049068",
				"detail_url": "https://item.jd.com/10103759260841.html",
				"reviews": 20000
			},
			{
				"title": "政府补贴  华为MateBook14 25款",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/376512/36/19426/90309/694a31f1F50582c3b/a4a28e7b896fae5f.jpg",
				"price": "5999.00",
				"sales": 3000,
				"num_iid": "10075922710112",
				"seller": "京东电竞官方旗舰店",
				"shop_id": "10393769",
				"detail_url": "https://item.jd.com/10075922710112.html",
				"reviews": 2000
			},
			{
				"title": "【政府补贴】华为笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/381291/10/14780/100177/6958e918F29f7e25c/8e1f998da1bf6036.jpg",
				"price": "5799.00",
				"sales": 10000,
				"num_iid": "10109249341545",
				"seller": "华为比特专卖店",
				"shop_id": "796063",
				"detail_url": "https://item.jd.com/10109249341545.html",
				"reviews": 10000
			},
			{
				"title": "华为MateBook14 25款国家补贴20%",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/379579/14/19701/78352/6955e0d3Fe77a6c40/6f5627ab5aba295c.jpg",
				"price": "6499.00",
				"sales": 3000,
				"num_iid": "10090623469751",
				"seller": "京东电竞官方旗舰店",
				"shop_id": "10393769",
				"detail_url": "https://item.jd.com/10090623469751.html",
				"reviews": 2000
			},
			{
				"title": "Hi MateBook 14 锐龙 200系列",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/380104/39/14588/43957/6954e404F3e20fa28/1684167c0423b2bb.jpg",
				"price": "6099.00",
				"sales": 2000,
				"num_iid": "100217084279",
				"seller": "华为京东自营旗舰店",
				"shop_id": "1000004259",
				"detail_url": "https://item.jd.com/100217084279.html",
				"reviews": 2000
			},
			{
				"title": "华为matebook14轻薄笔记本电脑",
				"pic_url": "https://img12.360buyimg.com/n2/s345x345_jfs/t1/295718/40/10820/34240/684fdc72F64661a9e/48547ee486c009e2.png",
				"price": "2389.00",
				"sales": 10000,
				"num_iid": "10139617789123",
				"seller": "Ultrabook商务本小店",
				"shop_id": "17195504",
				"detail_url": "https://item.jd.com/10139617789123.html",
				"reviews": 5000
			}
		]
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "b4f7b872ac8d3641d8acd4486d687696",

限流暴击：5 次请求就被封，大促前断了竞品监控

京东关键字接口的限流规则，是我见过最严格的 ——免费开发者仅 5 次 / 分钟请求限额，比评论接口（10 次 / 分钟）还严，超过后不仅返回429 Too Many Requests，还会直接封禁 IP 24 小时，连沙箱环境都不例外。

有次 618 大促前，我帮老板监控 10 个竞品 SKU 的价格，每 10 分钟搜索一次，1 小时内发了 6 次请求，结果 IP 被封，竞品监控直接中断。老板追责时，我才意识到限流的严重性 —— 免费版完全撑不起批量搜索，而企业版要 5000 元 / 月，短期内只能靠限流算法硬扛。

我用 “滑动窗口 + 指数退避” 写了限流类，严格控制请求频率，还加了失败重试（接口偶尔因网络延迟返回 504），从此再也没被封过：

python

运行

import time
from collections import deque

class JD SearchLimiter:
    def __init__(self, max_calls=5, period=60):
        """京东关键字接口限流：max_calls次/period秒（免费版5次/分钟）"""
        self.max_calls = max_calls
        self.period = period
        self.call_timestamps = deque()  # 存储每次请求的时间戳
    
    def can_call(self):
        """判断是否可发起请求，可调用则记录时间戳"""
        now = time.time()
        # 移除周期外的请求记录
        while self.call_timestamps and now - self.call_timestamps[0] > self.period:
            self.call_timestamps.popleft()
        if len(self.call_timestamps) < self.max_calls:
            self.call_timestamps.append(now)
            return True
        return False
    
    def wait_for_call(self, retry=3):
        """等待到可请求状态，失败重试3次"""
        wait_time = 0
        for _ in range(retry):
            if self.can_call():
                return True, wait_time
            # 指数退避等待（1s→2s→4s），避免频繁重试触发封禁
            wait_time = (2 ** _) + 0.1
            time.sleep(wait_time)
        return False, wait_time

# 示例：批量监控10个竞品的搜索结果
limiter = JD SearchLimiter(max_calls=5)
keywords = ["无线蓝牙耳机", "机械键盘", "游戏鼠标"]  # 要监控的关键字

for keyword in keywords:
    can_call, wait_time = limiter.wait_for_call()
    if not can_call:
        print(f"请求频繁，{keyword}监控失败，建议升级企业版")
        continue
    if wait_time > 0:
        print(f"触发限流，等待{wait_time:.1f}秒后搜索：{keyword}")
    # 发起搜索请求（省略具体逻辑）
    print(f"正在搜索关键字：{keyword}，获取竞品数据...")
    time.sleep(1)  # 模拟请求耗时

做京东评论分析系统 3 年，京东评论数据解析

Mon, 22 Dec 2025 15:15:43 +0800

数据解析陷阱：漏了追评，商家差评预警漏了 30% 的差评

系统上线后第二周，商家反馈：“昨天的 12 条差评，系统只预警了 8 条！” 排查发现，京东评论的返回结果藏着 “双字段陷阱”——主评存在comments字段，追评（追加评论）存在after_comments字段，我只解析了comments，完全漏掉了追评里的差评：比如用户买了商品 3 天后追加的 “质量差，掉漆”，系统没抓到，导致商家没及时回复，店铺动态评分掉了 0.2 分。

更坑的是，带图评论的图片 URL 藏在images的url字段里，且部分追评的images是嵌套结构，直接取值会报 KeyError；另外京东会对用户昵称脱敏（比如 “张 **”），如果直接展示会出现乱码。我连夜重写的评论解析函数，专门整合主评、追评、带图评论和情感判断：

python实例

jd.review/测试调试

		"real_total_results": 500000,
		"total_results": 500000,
		"page_size": 10,
		"page": "1",
		"item": [
			{
				"rate_content": "大品牌质量好使用方便价格便宜",
				"rate_date": "2025-12-22 14:10:35",
				"pics": [],
				"rate_id": "103553730157088578",
				"guid": "T6NdPMJ0j58tdR-BW66QxXiJ",
				"score": 5,
				"display_user_nick": "xujian1966",
				"auction_sku": "BM1(S2);",
				"add_feedback": null
			},
			{
				"rate_content": "这是第二次回购确实有蛮实用给五星好评",
				"rate_date": "2025-12-22 14:04:22",
				"pics": [
					"jfs/t1/375305/12/20041/261755/6948df61F9fd28fd4/00a94ecaf014c703.jpg",
					"jfs/t1/376768/4/18439/269304/6948df65F5fed58df/00a94ecaf00b6fbc.jpg",
					"jfs/t1/379944/35/12289/321964/6948df64Fe0093753/00a94ecaf06eea35.jpg",
					"jfs/t1/373946/31/20633/335073/6948df62Ff02f42fe/00a94ecaf0921005.jpg"
				],
				"rate_id": "103543710155619542",
				"guid": "T6NdPMN0j50tdR-DXaeRxXuD",
				"score": 5,
				"display_user_nick": "jd_152740bfh",
				"auction_sku": "BM1(S2);",
				"add_feedback": null
			},
			{
				"rate_content": "非常好",
				"rate_date": "2025-12-22 12:58:29",
				"pics": [],
				"rate_id": "103541160162348180",
				"guid": "T6NdPMN2iZotdRyEWKKQwXeB",
				"score": 5,
				"display_user_nick": "jd_8hw1mybnt7ic1p",
				"auction_sku": "BM1(S2);",
				"add_feedback": null
			},
			{
				"rate_content": "好用的，经常回购，下次继续回购，推荐",
				"rate_date": "2025-12-22 12:31:51",
				"pics": [],
				"rate_id": "103045080228559127",
				"guid": "T6NdOcNyiJQtdhiOXqORwX2G",
				"score": 5,
				"display_user_nick": "扶摇公子Kiss",
				"auction_sku": "BM1(S2);",
				"add_feedback": null
			},

运行

def parse_jd_comments(comment_data):
    """
    解析京东评论：整合主评/追评、带图评论、情感判断
    :param comment_data: 接口返回的评论数据
    """
    all_comments = []
    # 1. 处理主评（必存在）
    main_comments = comment_data.get("result", {}).get("comments", [])
    for main in main_comments:
        # 提取带图评论的图片URL（无图则返回空列表）
        comment_images = [img.get("url") for img in main.get("images", []) if img.get("url")]
        # 情感判断：1-2分=差评，3分=中评，4-5分=好评
        emotion = "差评" if main.get("score", 3) <=2 else "中评" if main.get("score")==3 else "好评"
        all_comments.append({
            "comment_id": main.get("id"),
            "user_nick": main.get("nickname", "匿名用户"),  # 脱敏昵称，如“李**”
            "emotion": emotion,
            "content": main.get("content", "").replace("\n", " "),  # 处理换行符
            "images": comment_images,
            "create_time": main.get("create_time"),
            "comment_type": "主评"
        })
    
    # 2. 处理追评（部分评论无追评，需判断）
    after_comments = comment_data.get("result", {}).get("after_comments", [])
    for after in after_comments:
        after_images = [img.get("url") for img in after.get("images", []) if img.get("url")]
        emotion = "差评" if after.get("score", 3) <=2 else "中评" if after.get("score")==3 else "好评"
        all_comments.append({
            "comment_id": after.get("id"),
            "user_nick": after.get("nickname", "匿名用户"),
            "emotion": emotion,
            "content": after.get("content", "").replace("\n", " "),
            "images": after_images,
            "create_time": after.get("create_time"),
            "comment_type": "追评"
        })
    
    # 按评论时间倒序排序（最新评论在前）
    return sorted(all_comments, key=lambda x: x["create_time"], reverse=True)
# 示例调用
raw_comment = {
    "result": {
        "comments": [
            {"id": "12345", "nickname": "张**", "score": 1, "content": "质量差", "images": [{"url": "xxx.jpg"}], "create_time": "2025-12-20 10:00"}
        ],
        "after_comments": [
            {"id": "12346", "nickname": "李**", "score": 1, "content": "追加：掉漆了", "images": [], "create_time": "2025-12-23 15:00"}
        ]
    }
}
parsed_comments = parse_jd_comments(raw_comment)
print(f"共解析{len(parsed_comments)}条评论，其中{len([c for c in parsed_comments if c['emotion']=='差评'])}条差
``