Developer API · 免费公开
新办公导航 开放 API 文档
把 7700+ 的站点数据、真实行为榜单与工具生态开放给开发者。全部 GET 接口，无需注册， 附 curl 示例可直接调试。适用于数据研究、聚合应用与被收录工具的徽章展示。
通用约定
- host 口径：统一为「去 www 的域名」（如
docs.qq.com），与站内数据、统计、评分完全同源。 - 限流：每 IP 每分钟 30~60 次（按接口不同），超限返回
429与 Retry-After；请客户端做好退避。 - CORS：全部开放接口允许跨域读取，可直接用于前端应用。
- 缓存：数据侧 24h 内存缓存（与页面 ISR 同步），健康状态取自构建期巡检（2026-10-17）。
1. 站点数据
GET/api/sites全站收录站点索引：名称、简介、分类归属、健康状态、收费档位。
| 参数 | 必填 | 说明 |
|---|---|---|
| channel | 否 | 按分站过滤，如 office / design |
| category | 否 | 按二级分类 id 过滤，如 docs |
| tier | 否 | 按收费档位过滤：free / freemium / paid |
请求示例
curl "https://www.xbgdh.com/api/sites?category=docs"
响应示例
{
"total": 128,
"sites": [
{
"name": "腾讯文档",
"url": "https://docs.qq.com",
"slug": "docs.qq.com",
"desc": "支持多人实时在线协作文档…",
"channel": "office",
"channelName": "办公提效",
"category": "docs",
"categoryName": "文档协作",
"hot": true,
"health": "up",
"price": "freemium"
}
]
}2. 人气榜单
GET/api/track真实行为数据榜单：好用榜（点赞）、收藏榜、热搜词，及单站计数。
| 参数 | 必填 | 说明 |
|---|---|---|
| top | 否 | likes=好用榜 / pins=收藏榜 / search=热搜词 |
| host | 否 | 单站模式：返回该站 views/clicks/likes 计数 |
请求示例
curl "https://www.xbgdh.com/api/track?top=likes"
响应示例
{
"items": [
{ "host": "docs.qq.com", "name": "腾讯文档", "likes": 342 }
]
}3. 评分聚合
GET/api/track站点匿名评分聚合（1-5 星），3 人以上有效。
| 参数 | 必填 | 说明 |
|---|---|---|
| host | 是 | 站点标识（去 www 域名） |
| kind | 是 | 固定 rating |
请求示例
curl "https://www.xbgdh.com/api/track?host=docs.qq.com&kind=rating"
响应示例
{ "avg": 4.6, "count": 28 }4. 个性化推荐
GET/api/recommend基于收藏/足迹种子的同分类热门补全，适合「看了又看」场景。
| 参数 | 必填 | 说明 |
|---|---|---|
| hosts | 是 | 种子站列表（逗号分隔，去 www 域名，≤24 个） |
| limit | 否 | 返回条数，默认 6，最大 12 |
请求示例
curl "https://www.xbgdh.com/api/recommend?hosts=feishu.cn,notion.so&limit=4"
响应示例
{
"items": [
{
"slug": "docs.qq.com",
"domain": "docs.qq.com",
"name": "腾讯文档",
"desc": "支持多人实时在线协作文档…"
}
]
}5. 站点点评
GET/api/review已审核通过的公开点评（精选置顶优先，最多 20 条）。
| 参数 | 必填 | 说明 |
|---|---|---|
| host | 是 | 站点标识（去 www 域名） |
请求示例
curl "https://www.xbgdh.com/api/review?host=docs.qq.com"
响应示例
{
"reviews": [
{
"id": "…",
"nickname": "匿名用户",
"body": "协作体验很顺滑…",
"tags": ["提效神器"],
"helpful": 12,
"reply": "感谢反馈！"
}
]
}6. OG 图片生成
GET/api/og品牌风格社交分享图（SVG），可直接用作 og:image。
| 参数 | 必填 | 说明 |
|---|---|---|
| t | 是 | 主标题（URL 编码） |
| d | 否 | 副文一行（URL 编码） |
请求示例
curl "https://www.xbgdh.com/api/og?t=2025%20%E5%B9%B4%E5%BA%A6%E5%B7%A5%E5%85%B7%E6%A6%9C"
响应示例
HTTP 200 Content-Type: image/svg+xml
7. 收录徽章
GET/api/badge站点收录徽章 Widget（SVG），回链详情页，适合放在被收录工具的官网。
| 参数 | 必填 | 说明 |
|---|---|---|
| host | 是 | 站点标识（去 www 域名） |
请求示例
curl "https://www.xbgdh.com/api/badge?host=docs.qq.com"
响应示例
HTTP 200 Content-Type: image/svg+xml
使用规范
- · 数据可用于个人与研究用途；商业聚合请保留来源署名并回链 https://www.xbgdh.com。
- · 请勿高频抓取全量数据（正确姿势：按需过滤 + 本地缓存 + 24h 刷新）。
- · 徽章与 OG 图可直接外链使用，无需下载转存。
- · 接口行为以实际响应为准，本页示例结构可能与版本迭代存在细微差异。