极阅 Data / Developer API
极阅 Data 开发者 API
用一个免费密钥，把公开的期刊指标读进你自己的脚本、扩展或 Agent。所有响应都带上来源标注与数据版本，方便你原样展示。
概述
接口返回的是来自社区公开快照的期刊指标（分区、影响因子、年度与 quartile
等），不是官方 JCR 或中科院分区出版物。每次响应都携带 source_label、source_version
与 attribution，展示数据时请一并显示。
- 查询内容只有 ISSN、期刊名等公开字段，不需要论文全文或任何账号凭据。
- 接口免费，注册后即可拿到密钥；密钥仅显示一次，请立即保存。
- 请求需携带
Authorization: Bearer jyk_...请求头。
快速开始
- 在开发者控制台输入邮箱获取验证码，登录后生成密钥。
-
密钥形如
jyk_…，只在生成时完整显示一次；之后控制台仅显示掩码。请把它保存在你自己的密钥管理处，不要提交到代码仓库。 - 带上请求头即可调用：
curl -sS -G 'https://data.jikeyan.cn/v1/open/journals/lookup' \
--data-urlencode 'issn=0028-0836' \
-H 'Authorization: Bearer jyk_...'接口
基础地址（base URL）：https://data.jikeyan.cn/v1/open
GET /journals/lookup
完整路径：/journals/lookup?issn=0028-0836；追加 &include_history=true 时一并返回历史年度指标数组。
curl -sS -G 'https://data.jikeyan.cn/v1/open/journals/lookup' \
--data-urlencode 'issn=0028-0836' \
-H 'Authorization: Bearer jyk_...'POST /journals/batch-lookup
批量查询，一次最多 50 个 ISSN，超出返回 422。
curl -sS -X POST 'https://data.jikeyan.cn/v1/open/journals/batch-lookup' \
-H 'Authorization: Bearer jyk_...' \
-H 'Content-Type: application/json' \
--data '{"issns":["0028-0836","1234-5678"]}'GET /journals/search
按名称模糊检索期刊，返回匹配列表，例如 /journals/search?q=cell。
curl -sS -G 'https://data.jikeyan.cn/v1/open/journals/search' \
--data-urlencode 'q=cell' \
-H 'Authorization: Bearer jyk_...'GET /datasets/current
读取当前数据集发布信息：版本、覆盖年份与发布日期，便于你判断本地缓存是否过期。
curl -sS 'https://data.jikeyan.cn/v1/open/datasets/current' \
-H 'Authorization: Bearer jyk_...'GET /me
读取当前密钥的信息：密钥标识、配额与当日已用次数。
curl -sS 'https://data.jikeyan.cn/v1/open/me' \
-H 'Authorization: Bearer jyk_...'响应说明
成功响应为 JSON。期刊对象 journal 与指标数组 metrics 并列返回。
| 字段 | 说明 |
|---|---|
| journal | 期刊对象：ISSN、刊名、学科等基础信息。 |
| metrics[] | 指标数组，每条包含下列字段。 |
| metric_family · metric_name | 指标族与指标名，例如分区族下的 quartile 指标。 |
| value_text · value_number | 指标值的文本形式与数值形式，二者按指标类型择一使用。 |
| year · category | 指标所属年份与学科类别。 |
| quartile · rank · denominator | 分区、排名与同类总数。 |
| is_top | 是否为学科前列（Top）标记。 |
| source_label · source_version | 来源标注与来源版本，展示数据时必须一并显示。 |
| attribution | 完整的归属文案，可直接用于页面脚注。 |
| dataset_release | 数据集发布标识：版本号与发布日期。 |
配额与错误码
配额按密钥计算：60 次/分钟、5000 次/天
。超限时返回 429，并在响应头给出 Retry-After。
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 401 | invalid_api_key | 密钥缺失、无效或已被吊销。 |
| 429 | rate_limited | 超出速率或每日配额，请按 Retry-After 等待后重试。 |
| 422 | — | 参数校验失败：ISSN 格式错误、批量条数超过 50 或缺少必填参数。 |
| 503 | open_api_disabled | 开放接口临时关闭，稍后重试。 |
使用条款
申请密钥即表示你同意以下条款：
- 必须标注来源。在页面、应用或文章中展示数据时，必须同时显示来源标注（
source_label/attribution）与数据版本（source_version/dataset_release）。 - 不得搬运数据集。禁止对数据集做批量镜像、转售或再分发，包括建立镜像站、打包出售或重新发布原始数据。
- 不得共享密钥。密钥仅限注册者本人使用，不要贴到公开仓库、聊天群或截图中。
- 滥用将被吊销。超限重试、自动化抓取、转售等行为会导致密钥被立即吊销。
- 服务按现状提供。没有 SLA，配额、限流与接口字段可能随时调整。
- 数据为社区公开快照。并非官方 JCR 或中科院分区出版物，不保证准确性、完整性与时效性，不作为科研评价或决策依据。
- 疑问或违规举报请联系 info@junshiantech.cn。
隐私
为发放密钥并统计配额，控制台账号仅保存以下信息：
- 注册邮箱；
- 密钥的哈希值（服务器不保存明文密钥）；
- 按天统计的请求次数；
- 审计事件，其中记录哈希后的 IP。
这些信息只用于配额、防盗用与安全排查。你可以随时在控制台删除账号，删除后上述记录一并清除。
技能
想让 Agent 直接查询期刊指标，可以安装 Agent Skill。仓库地址（暂以纯文本给出，公开后可再更新为链接）：
https://github.com/871922384/jiyan-journal-data-skill安装后导出你的密钥即可使用：
export JIYAN_API_KEY=jyk_...密钥等同于你的配额与身份，请勿提交到代码仓库或写入公开脚本；不要共享密钥。