💳 京东开放平台(JOS)免费额度与收费标准(2026版):基础/联盟/商家接口对照表(附Python源码)
直接给结论:
京东开放平台绝大多数商品查询、订单同步、物流跟踪、库存快照接口有免费日调用额度(企业应用通常数万~百万/天),超免费额度后按量计费(聚石塔内≈¥0.02~0.10/百次);京东联盟选品/佣金接口备案后免费调用(成交抽佣金不收API费);CRM/数据洞察属增值包。 中小自营ERP通常零或极低费用。
一、JOS 接口收费分层(2026参考)
类型 | 代表接口 | 是否收费 | 说明 |
|---|---|---|---|
免费API | jingdong.ware.read.get(商品详情)、jingdong.ware.sku.read(SKU)、jd.order.detail.get(查自己订单明细★需token)、jingdong.etms.trace.get(轨迹)、jingdong.stock.get(库存快照) | ✅ 免费额度内¥0 | 个人应用额度低(数百~数千/天),企业实名应用高(5万~100万+/天) |
基础收费API | 高频订单列表翻页( jingdong.pop.order.search超量)、批量操作 | 💰 超免费额度按量计费 | 聚石塔内≈¥0.02~0.05/百次;聚石塔外≈¥0.10~0.20/百次 |
增值API | 会员RFM分析、数据罗盘、竞品洞察 | 💰 需购增值包 | 聚石塔内调用,按包/按量 |
京东联盟API | jd.union.open.goods.query、jd.union.open.goods.detail.query | ✅ 备案后免费调用 | 成交后阿里妈妈类推收佣金,API本身不收费;日限约10万~100万次 |
电子面单(无界) | jingdong.etms.waybill.get | 💰 按面单数计费 或含在京东仓服务包 | 取号即计费(通常几分/单),取消未揽收不扣 |
⚠️ 关键:做商品主数据同步 + 订单回写 + 发货回填 → 基础免费额度通常够用,只有日调用量极大(>50万次)或需数据增值包才产生费用。
二、基础/增值/联盟接口对照表(高频)
接口 | 分类 | 收费 | QPS典型(企业) |
|---|---|---|---|
jingdong.ware.read.get | 免费API | 否(额度内) | 2~5/s(可提) |
jingdong.ware.sku.read | 免费API | 否(额度内) | 同上 |
jingdong.stock.get/ ware.stock.get | 免费API | 否(额度内) | — |
jingdong.pop.order.search | 免费API(基础) | 超量计费 | 5~10/s |
jd.order.detail.get | 免费API(基础) | 超量计费 | 5~10/s |
jingdong.etms.trace.get | 免费API | 否(额度内) | — |
jingdong.etms.waybill.send(回填) | 免费API | 否 | — |
jd.union.open.goods.detail.query | 免费API(联盟) | 否(备案) | 5~10/s |
jingdong.crm.member.get(高级) | 增值API | 💰 需包 | — |
jingdong.etms.waybill.get(电子面单取号) | 电子面单 | 💰 按面单 | — |
三、Python:用量探测 + 日额度耗尽捕获示例
# jd_quota_check.py
"""
京东JOS API 费用/额度探测
- 调免费接口 taobao.item.get 类比 → jingdong.ware.read.get
- 捕获 accesscontrol.limited-by-app-access-count → 日免费额度耗尽提示
"""
import hashlib
import json
import requests
import time
from typing import Dict
封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex
class _JdProbe:
GW = "https://api.jd.com/routerjson"
def __init__(self, ak, ask):
self.ak, self.ask = ak, ask
def _sign(self, p: Dict) -> str:
filt = sorted((k, v) for k, v in p.items()
if v is not None and str(v).strip() != '' and k != 'sign')
qs = ''.join(f"{k}{v}" for k, v in filt)
return hashlib.md5(f"{self.ask}{qs}{self.ask}".encode()
).hexdigest().upper()
def _call(self, method, biz, token=None):
p = {
"app_key": self.ak, "method": method,
"timestamp": str(int(time.time())),
"format": "json", "v": "2.0", "sign_method": "md5",
"360buy_param_json": json.dumps(biz, ensure_ascii=False,
separators=(',', ':'))
}
if token:
p["access_token"] = token
p["sign"] = self._sign(p)
r = requests.post(self.GW, data=p, timeout=15)
r.raise_for_status()
d = r.json()
if "error_response" in str(d):
err = d.get(list(d.keys() - {"error_response"})[0],
{}).get("error_response") or d.get("error_response")
if err:
code = str(err.get("code", ""))
sub = err.get("sub_code", "")
msg = err.get("zh_desc") or err.get("en_desc")
if "limited-by-app-access-count" in sub or "quota" in msg.lower():
print("\n🚨 【日免费额度耗尽】")
print(" → 超量按基础API费率计费(聚石塔内≈¥0.02~0.05/百次)")
print(" → 建议: 用增量(modified)同步、fields过滤、申请提额\n")
elif "no permission" in msg:
print(f"\n❌ 【无权限】接口未申请或需用企业应用\n")
else:
print(f"\n❌ JOS [{code}] {msg} {err.get('sub_code','')}\n")
raise Exception(f"JOS probe err: {err}")
# 简单取 ware 节点
for k in d:
if k.endswith("_response"):
return d[k]
return d
def probe_item(self, ware_id="100012345678", token=None):
return self._call(
"jingdong.ware.read.get",
{"wareId": ware_id,
"fields": "ware_id,title,jd_price,stock_num"},
token=token
).get("ware", {})
if __name__ == "__main__":
probe = _JdProbe("YOUR_JD_APP_KEY", "YOUR_JD_APP_SECRET")
try:
ware = probe.probe_item("100012345678")
print("✅ JOS连通正常!商品:", ware.get("title","(mock)"))
print(" → 此调用消耗【免费额度】,未超不收费")
print("\n📋 费用小结:")
print(" • 商品/订单/轨迹 → 免费额度内 ¥0")
print(" • pop.order.search 超量 → 聚石塔内≈¥0.02~0.05/百次")
print(" • 京东联盟 jd.union.* → 备案后免费(成交抽佣)")
print(" • 电子面单取号 → 按面单数计费(或含仓配包)")
print(" • CRM增值分析 → 需购增值包")
except Exception as e:
# 已在内层分类打印
pass四、降本与避坑建议
- 字段过滤
fields必传 → 减少返回体积,不易触发隐性扫描限流 - 订单增量同步:用
start_modified/end_modified每 5~30 min 拉变更 → 大幅降调用量 - 商品全量翻页加断点:记录
max_modified下次从此继续,防重启重跑耗额度 - 聚石塔内部署:ECS在聚石塔内基础API单价低一个量级
- 日额度监控:开放平台控制台→统计分析→API调用量,设告警接近耗尽切增量模式
五、面试/方案一句话
京东JOS平台:商品/订单/物流/库存API有日免费额度(企业通常数万~百万)不收费,超量按基础API约¥0.02~0.05/百次(聚石塔内)计费;京东联盟选品接口备案后免费(API不收费成交抽佣);电子面单取号按面单计费;CRM数据洞察需增值包。中小ERP商品+订单同步通常零费。
需要我补 京东订单增量同步APScheduler(断点续跑+Token自动刷新) 或 京东商品全量SKU翻页带fields过滤示例 吗?