官网集

开放接口文档

官网集向所有开发者免费开放只读查询接口，无需注册、无需密钥，返回 JSON。适合做聚合导航、数据研究或第三方应用接入。请合理使用（建议每分钟不超过 60 次请求），写入类接口不在开放范围。

免注册免密钥

直接发 HTTP 请求就能用，返回标准 JSON，不需要鉴权头。

只读接口

仅开放查询能力；提交收录、点评等写入操作请走对应页面。

数据同源

接口数据与网站页面同库同源，先审后发，接口里不会有未审核内容。

GET/api/sites已收录站点列表，默认返回审核通过的站点。

参数

status可选默认 approved；传 pending/rejected 查对应状态（仅 approved 开放全部字段）
category可选按分类 slug 过滤，如 dev
sub可选按子分类 slug 过滤
q可选关键词搜索站名与描述
sort可选hot 按热度（默认）｜oldest 按收录时间正序
limit可选返回条数，默认 50，最大 200

请求示例

curl "https://www.guanwangji.com/api/sites?category=dev&limit=5"

返回示例

{
  "sites": [
    { "id": "s12", "name": "GitHub", "url": "https://github.com",
      "domain": "github.com", "description": "…", "clicks": 1234 }
  ]
}
GET/api/sites/{id}单个站点详情，含分类、收费模式与收录时间。

参数

id必填站点 ID，路径参数，如 s12

请求示例

curl "https://www.guanwangji.com/api/sites/s12"

返回示例

{
  "site": { "id": "s12", "name": "GitHub", "category": "dev",
    "sub": "code", "pricing": "freemium", "reviewedAt": "2026-09-24T…" }
}
GET/api/categories全部分类树，含每个分类与子分类的收录数量。

无参数，直接请求即可。

请求示例

curl "https://www.guanwangji.com/api/categories"

返回示例

{
  "categories": [
    { "slug": "dev", "name": "开发技术", "siteCount": 42,
      "subs": [{ "slug": "code", "name": "编程开发", "siteCount": 18 }] }
  ]
}
GET/api/stats全站统计：收录总数、分类数、快讯数与自动化开关状态。

无参数，直接请求即可。

请求示例

curl "https://www.guanwangji.com/api/stats"

返回示例

{
  "ok": true,
  "sites": 356, "approved": 356, "categories": 25,
  "articles": 58, "autoReview": true
}
GET/api/comments某个站点的网友点评（已审核，倒序前 20 条）。

参数

siteId必填站点 ID，如 siteId=s12

请求示例

curl "https://www.guanwangji.com/api/comments?siteId=s12"

返回示例

{
  "comments": [
    { "id": "cm3", "name": "阿凯", "content": "文档很全…", "createdAt": "…" }
  ]
}
GET/api/ratings某个站点的评分汇总：总分、人数与易用性/速度/免费度三维。

参数

siteId必填站点 ID，如 siteId=s12

请求示例

curl "https://www.guanwangji.com/api/ratings?siteId=s12"

返回示例

{
  "ok": true, "summary": { "avg": 4.5, "count": 12,
    "ease": 4.6, "speed": 4.4, "free": 4.2 }
}
GET/api/articles收录快讯列表（自动发布的收录动态）。

参数

limit可选返回条数，默认 20

请求示例

curl "https://www.guanwangji.com/api/articles?limit=10"

返回示例

{
  "articles": [
    { "id": "a21", "title": "官网集新收录：…", "createdAt": "…" }
  ]
}
GET/feed.xmlRSS 2.0 订阅源：最新收录 20 条，可直接接入 RSS 阅读器。

无参数，直接请求即可。

请求示例

curl "https://www.guanwangji.com/feed.xml"

返回示例

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"><channel>
  <title>官网集 · 最新收录</title>…
</channel></rss>

使用约定