开发者接口 API SDK

NB频道的公开只读数据接口：虚拟股票市值、评论、站点统计、实时粉丝数。适合友商、插件、脚本与一切想与 NB 频道互通的小伙伴。

Base URL: api.nb-channel.top

1关于 API Key

2026-09-25 起，主要接口需要 API Key。起因是有人把接口地址写进自己网站的脚本里、每秒轮询一次，持续消耗本站服务器与数据库额度，所以给接口加上了鉴权。

怎么申请：发邮件到 nbchannel@163.com，或在站内评论区 @NB频道官方，说明用途和大概的调用频率即可。友商、正常做插件或数据展示的一律给。

怎么用：请求时带上 X-API-Key 请求头（推荐），或加 ?key= 参数。

curl -H "X-API-Key: 你申请到的Key" "https://api.nb-channel.top/api/market"

不要用 ?key= 把 Key 拼在网址里 —— URL 会进日志和 referrer，容易泄露。用请求头更安全。也请不要把 Key 提交到公开的代码仓库。

2端点一览

端点	鉴权	说明
`GET /api/market`	需 Key	全市场快照：公司列表 + 总市值 + 公司数?name=关键词可选，按公司名模糊查询（最多 50 家）
`GET /api/market/<公司ID>`	需 Key	单家公司市值
`GET /api/market/<ID>/history?days=7`	需 Key	历史市值走势点（days 1~30）
`GET /api/market/export?format=csv`	需 Key	全市场 CSV 导出
`GET /api/comments`	需 Key	最新评论（只读）?page=1&limit=20&page_path=comments-beta.html
`GET /api/stats`	需 Key	接口用量统计（开发用）
`GET /api/bili-fans`	公开	B站实时粉丝数（官网首页数据条同源，约 30 秒缓存）
`GET /api/docs`	公开	完整接口文档页

限流：每 IP 每分钟 60 次，超出返回 429 RATE_LIMITED。缺 Key 或 Key 错误返回 401 UNAUTHORIZED。

3快速上手

# 命令行直接试（把 Key 换成你申请到的）
curl -H "X-API-Key: 你的Key" "https://api.nb-channel.top/api/market"          # 全市场
curl -H "X-API-Key: 你的Key" "https://api.nb-channel.top/api/market?name=NB"   # 找 NB 相关的公司
curl -H "X-API-Key: 你的Key" "https://api.nb-channel.top/api/market/1/history?days=7"

# 公开接口，不需要 Key
curl "https://api.nb-channel.top/api/bili-fans"

NBMarket.setApiKey('你申请到的 Key');   // 先填 Key
const m = await NBMarket.market();
console.log('总市值', m.total_market_value, '公司数', m.count);

4语言示例包

⬇ JavaScript 示例（js_example.js） ⬇ Python 示例（python_example.py） ⬇ 使用说明（README.md）

浏览器直接用 <script src="js_example.js"></script> 即可获得全局 window.NBMarket，调 setApiKey() 填入 Key 后即可使用；Node.js 与 Python 用法见各文件头部注释（Python 用 NBMarket(api_key="...")）。

查看完整接口文档 ↗