API 文档

期刊综合数据 API - 包括期刊索引、JCR 影响因子（2020-2024）和中科院分区（2021-2025）

基本信息

接口地址: GET /api/public/journals
数据内容: 期刊索引 + JCR 影响因子（5年）+ 中科院分区（4年）
JCR 数据: 2020-2024年（100,097条记录）
中科院分区: 2021-2025年（60,365条记录）
返回格式: JSON
认证方式: 无需认证（公开接口）

请求参数

参数名	类型	必填	默认值	说明
`page`	number	否	1	页码（从 1 开始）
`pageSize`	number	否	20	每页数量（1-200）
`q`	string	否	-	搜索关键词（匹配 ISSN、标题、出版商）
`inDoaj`	boolean	否	-	是否在 DOAJ 中
`inNlm`	boolean	否	-	是否在 NLM 中
`hasWikidata`	boolean	否	-	是否有 Wikidata 记录
`isOpenAccess`	boolean	否	-	是否为开放获取
`sortBy`	string	否	-	排序字段
`sortOrder`	string	否	desc	排序顺序（asc/desc）

sortBy 可选值：

primary_issntitlepublishercountryworks_countcited_by_countupdated_at

返回格式

完整示例

{
  "ok": true,
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "total": 70519,
    "totalPages": 3526
  },
  "filters": {
    "q": null,
    "inDoaj": true,
    "inNlm": null,
    "hasWikidata": null,
    "isOpenAccess": null,
    "sortBy": "updated_at",
    "sortOrder": "desc"
  },
  "data": [
    {
      "primary_issn": "0007-9235",
      "unified_index": {
        "title": "CA-A CANCER JOURNAL FOR CLINICIANS",
        "publisher": "Wiley",
        "country": "US",
        "languages": ["en"],
        "subjects": ["Oncology", "Medicine"],
        "is_open_access": 0,
        "in_doaj": 0,
        "in_nlm": 1,
        "has_wikidata": 1,
        "works_count": 15000,
        "cited_by_count": 500000,
        "updated_at": "2026-01-19 12:00:00"
      },
      "jcr": {
        "total_years": 5,
        "data": [
          {
            "year": 2024,
            "journal": "CA-A CANCER JOURNAL FOR CLINICIANS",
            "issn": "0007-9235",
            "eissn": "1542-4863",
            "category": "ONCOLOGY(SCIE)",
            "impact_factor": 232.4,
            "quartile": "Q1",
            "rank": "1/326"
          }
        ]
      },
      "cas_partition": {
        "total_years": 4,
        "data": [
          {
            "year": 2025,
            "journal": "CA-A CANCER JOURNAL FOR CLINICIANS",
            "issn": "0007-9235/1542-4863",
            "major_category": "医学",
            "major_partition": "1",
            "is_top_journal": true,
            "minor_categories": [
              {
                "category": "ONCOLOGY 肿瘤学",
                "partition": "1 [1/326]"
              }
            ]
          }
        ]
      }
    }
  ]
}

请求示例

1. 获取第一页数据（默认 20 条）

GET /api/public/journals

2. 获取第 2 页，每页 50 条

GET /api/public/journals?page=2&pageSize=50

3. 搜索标题包含 "science" 的期刊

GET /api/public/journals?q=science

4. 筛选 DOAJ 中的开放获取期刊

GET /api/public/journals?inDoaj=true&isOpenAccess=true

5. 按引用次数降序排序

GET /api/public/journals?sortBy=cited_by_count&sortOrder=desc

6. 组合查询示例

GET /api/public/journals?page=1&pageSize=100&inDoaj=true&sortBy=works_count&sortOrder=desc

错误代码

HTTP 状态码	说明
200	请求成功
400	请求参数错误
500	服务器内部错误

错误响应格式：

{
  "ok": false,
  "error": "Invalid parameters",
  "details": [ ... ]
}