test/skills/aminer-open-academic/references/api-catalog.md
2026-03-24 04:04:58 +00:00

26 KiB
Executable File
Raw Blame History

AMiner 开放平台 API 完整参考手册

基础域名https://datacenter.aminer.cn/gateway/open_platform
认证方式:所有接口在请求头中携带 Authorization: <TOKEN>
Token 获取:登录 控制台 生成,在下方所有 curl 示例中将 <TOKEN> 替换为你的实际 Token。


目录


论文类 API

1. 论文搜索

  • URLGET /api/paper/search
  • 价格:免费
  • 说明:根据论文标题搜索,返回论文 ID、标题、DOI

请求参数:

参数名 类型 必填 说明
page number 页码(从 0 开始,最大为 0
size number 每页条数
title string 论文标题关键词

响应字段:

字段名 说明
id 论文 ID
title 论文英文标题
title_zh 论文中文标题
doi DOI
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/search?page=0&size=5&title=BERT' \
  -H 'Authorization: <TOKEN>'

2. 论文搜索 pro

  • URLGET /api/paper/search/pro
  • 价格¥0.01/次
  • 说明:多条件搜索,支持关键词、摘要、作者、机构、期刊等过滤

请求参数:

参数名 类型 必填 说明
page number 页数(从 0 开始)
size number 每页条数
title string 标题关键词
keyword string 关键词
abstract string 摘要关键词
author string 作者名
org string 机构名
venue string 期刊名
order string 排序字段:year(年份降序)或 n_citation(引用量降序),不传为综合排序

响应字段:

字段名 说明
id 论文 ID
title 英文标题
title_zh 中文标题
doi DOI
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/search/pro?title=transformer&author=Vaswani&order=n_citation&page=0&size=5' \
  -H 'Authorization: <TOKEN>'

3. 论文问答搜索

  • URLPOST /api/paper/qa/search
  • 价格¥0.05/次
  • 说明AI 智能问答搜索,支持自然语言提问和结构化关键词联合搜索

请求参数:

参数名 类型 必填 说明
use_topic boolean 是否使用联合关键词搜索。true 时使用 topic 字段,false 时使用 title/query
topic_high string use_topic=true 时有效必须匹配的关键词AND 逻辑),嵌套数组格式:[["词A","词B"],["词C"]] 外层 AND内层 OR
topic_middle string 大幅加分词,格式同 topic_high
topic_low string 小幅加分词,格式同 topic_high
title []string use_topic=false 时的标题查询
doi string DOI 精确查询
year []number 年份筛选数组
sci_flag boolean 是否只返回 SCI 论文
n_citation_flag boolean 是否对高引用量论文加分
size number 返回数量(最大值)
offset number 偏移量
force_citation_sort boolean 完全按照引用量排序
force_year_sort boolean 完全按照年份排序
author_terms []string 作者名查询,数组内为 OR 关系,建议多写变体
org_terms []string 机构名查询,数组内为 OR 关系
query string 自然语言原始问题(较慢),系统自动拆解关键词。与 topic_high 同时传时以此参数为准

响应字段:

字段名 说明
data 论文 ID 列表
id 论文 ID
title 论文标题
title_zh 中文标题
doi DOI
Total / total 总数

curl 示例(自然语言问答):

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/qa/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"use_topic": false, "query": "深度学习蛋白质结构预测", "size": 10, "sci_flag": true}'

curl 示例(结构化关键词):

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/qa/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{
    "use_topic": true,
    "topic_high": "[[\\"transformer\\",\\"self-attention\\"],[\\"protein folding\\"]]",
    "topic_middle": "[[\"AlphaFold\"]]",
    "sci_flag": true,
    "force_citation_sort": true,
    "size": 10
  }'

4. 论文信息

  • URLPOST /api/paper/info
  • 价格:免费
  • 说明:批量根据论文 ID 获取基础信息(标题、卷号、期刊、作者)

请求参数:

参数名 类型 必填 说明
ids []string 论文 ID 数组

响应字段:

字段名 说明
_id 论文 ID
title 论文标题
authors 作者列表(含 name/name_zh
issue 卷号
raw 期刊名称
venue 期刊信息对象

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/info' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"ids": ["53e9ab9bb7602d97023e53b2", "53e9a98eb7602d9703e42e5a"]}'

5. 论文详情

  • URLGET /api/paper/detail
  • 价格¥0.01/次
  • 说明:根据论文 ID 获取完整详情

请求参数:

参数名 类型 必填 说明
id string 论文 ID

响应字段:

字段名 说明
id 论文 ID
title 英文标题
title_zh 中文标题
abstract 摘要
abstract_zh 中文摘要
authors 作者列表name/name_zh/org/org_zh
doi DOI
issn ISSN
issue 卷号
volume
year 年份
keywords 关键词
keywords_zh 中文关键词
raw 期刊名称
venue 期刊信息对象

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/detail?id=53e9ab9bb7602d97023e53b2' \
  -H 'Authorization: <TOKEN>'

6. 论文引用

  • URLGET /api/paper/relation
  • 价格¥0.10/次
  • 说明:根据论文 ID 获取该论文引用的论文列表

请求参数:

参数名 类型 必填 说明
id string 论文 ID

响应字段:

字段名 说明
_id 论文 ID
title 标题
cited 该论文引用的其他论文基础信息
n_citation 被引用次数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/relation?id=53e9ab9bb7602d97023e53b2' \
  -H 'Authorization: <TOKEN>'

7. 论文搜索接口(综合搜索)

  • URLGET /api/paper/list/by/search/venue
  • 价格¥0.30/次
  • 说明:通过关键词或作者或期刊名称获取论文完整信息(含摘要、机构、期刊详情)

请求参数:

参数名 类型 必填 说明
page number 页码数
size number 每页条数
keyword string 关键词(与 venue/author 三选一)
venue string 期刊名称(与 keyword/author 三选一)
author string 作者名称(与 keyword/venue 三选一)
order string 排序:yearn_citation,不传为综合排序

响应字段(主要):

字段名 说明
_id 论文 ID
title / title_zh 论文标题(中英文)
abstract / abstract_zh 摘要(中英文)
authors 作者信息(含机构 ID、别名、详情
venue 期刊信息(中英文名、别名)
venue_hhb_id 期刊 ID
keywords / keywords_zh 关键词(中英文)
year 发表年份
n_citation 引用量
doi DOI
url 论文跳转地址
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/list/by/search/venue?keyword=graph+neural+network&page=0&size=10&order=n_citation' \
  -H 'Authorization: <TOKEN>'

8. 论文批量查询(多关键词)

  • URLGET /api/paper/list/citation/by/keywords
  • 价格¥0.10/次
  • 说明:通过多关键词获取论文关键词、摘要等信息

请求参数:

参数名 类型 必填 说明
page number 页码数
size number 每页条数
keywords string 关键词数组JSON 字符串格式)

响应字段:

字段名 说明
id 论文 ID
title / title_zh 标题(中英文)
abstract / abstract_zh 摘要(中英文)
keywords / keywords_zh 关键词(中英文)
doi DOI
year 年份
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/list/citation/by/keywords?page=0&size=10&keywords=%5B%22deep+learning%22%2C%22object+detection%22%5D' \
  -H 'Authorization: <TOKEN>'

9. 按年份与期刊获取论文详情

  • URLGET /api/paper/platform/allpubs/more/detail/by/ts/org/venue
  • 价格¥0.20/次
  • 说明根据论文发表年份与期刊获取论文标题、作者、DOI、关键词等详情

注意venue_idyear 须同时传入,仅传 year 接口返回 null。可先通过期刊搜索接口获取 venue_id

请求参数:

参数名 类型 必填 说明
year number 论文发表年份
venue_id string 期刊 ID通过期刊搜索接口获取不传返回 null

响应字段(主要):

字段名 说明
_id 论文 ID
title / title_zh 标题(中英文)
abstract 摘要
authors 作者数组name/org/email/homepage/orc_id/_id
doi DOI
issn ISSN
keywords / keywords_zh 关键词(中英文)
year 年份
venue 期刊信息

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/platform/allpubs/more/detail/by/ts/org/venue?year=2023&venue_id=<VENUE_ID>' \
  -H 'Authorization: <TOKEN>'

学者类 API

10. 学者搜索

  • URLPOST /api/person/search
  • 价格:免费
  • 说明:根据姓名(或机构)搜索学者,返回 ID、姓名、机构

请求参数:

参数名 类型 必填 说明
name string 学者姓名
org string 机构名
org_id []string 机构实体 ID 数组
offset number 起始位置(最大为 0
size number 返回条数(最大 10

响应字段:

字段名 说明
id 学者 ID
name 英文姓名
name_zh 中文姓名
org 英文机构
org_zh 中文机构
org_id 机构 ID
interests 研究兴趣
n_citation 引用量
total 总数

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/person/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"name": "Andrew Ng", "size": 5}'

11. 学者详情

  • URLGET /api/person/detail
  • 价格¥1.00/次
  • 说明:根据学者 ID 获取完整个人信息

请求参数:

参数名 类型 必填 说明
id string 学者 ID

响应字段:

字段名 说明
id / person_id 学者 ID
name / name_zh 姓名(中英文)
bio / bio_zh 个人简介(中英文,不同时存在)
edu / edu_zh 教育经历(中英文)
orgs / org_zhs 机构列表(英文/中文)
position / position_zh 职称(中英文)
domain 研究领域
honor 荣誉
award 奖项
year 年份

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/person/detail?id=53f3ae78dabfae4b34b0c75d' \
  -H 'Authorization: <TOKEN>'

12. 学者画像

  • URLGET /api/person/figure
  • 价格¥0.50/次
  • 说明:获取研究兴趣、领域及结构化工作/教育经历

请求参数:

参数名 类型 必填 说明
id string 学者 ID

响应字段:

字段名 说明
id 学者 ID
ai_interests 研究兴趣列表
ai_domain 研究领域列表
edus 结构化教育经历
works 结构化工作经历

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/person/figure?id=53f3ae78dabfae4b34b0c75d' \
  -H 'Authorization: <TOKEN>'

13. 学者论文

  • URLGET /api/person/paper/relation
  • 价格¥1.50/次
  • 说明获取学者发表的论文列表ID + 标题)

请求参数:

参数名 类型 必填 说明
id string 学者 ID

响应字段:

字段名 说明
author_id 学者 ID
id 论文 ID
title 论文标题

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/person/paper/relation?id=53f3ae78dabfae4b34b0c75d' \
  -H 'Authorization: <TOKEN>'

14. 学者专利

  • URLGET /api/person/patent/relation
  • 价格¥1.50/次
  • 说明:获取学者相关的专利列表

请求参数:

参数名 类型 必填 说明
id string 学者 ID

响应字段:

字段名 说明
patent_id 专利 ID
person_id 学者 ID
title 专利标题
en 英文标题
zh 中文标题

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/person/patent/relation?id=53f3ae78dabfae4b34b0c75d' \
  -H 'Authorization: <TOKEN>'

15. 学者项目

  • URLGET /api/project/person/v3/open
  • 价格¥3.00/次
  • 说明:获取学者参与的科研项目(资助金额、时间、来源)

请求参数:

参数名 类型 必填 说明
id string 学者 ID

响应字段:

字段名 说明
id 项目 ID
titles 项目标题
country 国家
project_source 项目来源
fund_amount 资助金额
fund_currency 资助货币
start_date 开始时间
end_date 结束时间
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/project/person/v3/open?id=53f3ae78dabfae4b34b0c75d' \
  -H 'Authorization: <TOKEN>'

机构类 API

16. 机构搜索

  • URLPOST /api/organization/search
  • 价格:免费
  • 说明:根据名称关键词搜索机构 ID 和名称

请求参数:

参数名 类型 必填 说明
orgs []string 机构名称数组

响应字段:

字段名 说明
org_id 机构 ID
org_name 机构名称
total 总数

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"orgs": ["Tsinghua University"]}'

17. 机构详情

  • URLPOST /api/organization/detail
  • 价格¥0.01/次
  • 说明:根据机构 ID 获取详情

请求参数:

参数名 类型 必填 说明
ids []string 机构 ID 数组

响应字段:

字段名 说明
id 机构 ID
name / name_en / name_zh 机构名(原始/英文/中文)
acronyms 简称
aliases 别名列表
details 机构详细描述
type 机构类型(大学/企业等)
location 地理位置
language 语言
total 总数

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/detail' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"ids": ["5f71b2091c455f439fe9a7d7"]}'

18. 机构学者

  • URLGET /api/organization/person/relation
  • 价格¥0.50/次
  • 说明:获取机构下的学者列表(每次返回 10 条)

请求参数:

参数名 类型 必填 说明
org_id string 机构 ID
offset number 起始位置(每次固定返回 10 条)

响应字段:

字段名 说明
id 学者 ID
name / name_zh 学者姓名(中英文)
org / org_zh 机构(中英文)
org_id 机构 ID
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/person/relation?org_id=5f71b2091c455f439fe9a7d7&offset=0' \
  -H 'Authorization: <TOKEN>'

19. 机构论文

  • URLGET /api/organization/paper/relation
  • 价格¥0.10/次
  • 说明:获取机构学者发表过的论文列表(每次返回 10 条)

请求参数:

参数名 类型 必填 说明
org_id string 机构 ID
offset number 起始位置(每次固定返回 10 条)

响应字段:

字段名 说明
id 论文 ID
title / title_zh 标题(中英文)
doi DOI
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/paper/relation?org_id=5f71b2091c455f439fe9a7d7&offset=0' \
  -H 'Authorization: <TOKEN>'

20. 机构专利

  • URLGET /api/organization/patent/relation
  • 价格¥0.10/次
  • 说明:获取机构拥有的专利 ID 列表,支持分页,单次最多返回 10000 条

请求参数:

参数名 类型 必填 说明
id string 机构 ID
page number 页码(从 1 开始)
page_size number 每页条数,最大 10000

响应字段:

字段名 说明
id 专利 ID
total 总数

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/patent/relation?id=6233173d0a6eb145604733e2&page=1&page_size=100' \
  -H 'Authorization: <TOKEN>'

21. 机构消歧

  • URLPOST /api/organization/na
  • 价格¥0.01/次
  • 说明:根据机构字符串(含缩写/别名)获取标准化机构名称

请求参数:

参数名 类型 必填 说明
org string 机构名称(可含别名/缩写)

响应字段:

字段名 说明
org_name 归一化机构名称

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/na' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"org": "MIT CSAIL"}'

22. 机构消歧 pro

  • URLPOST /api/organization/na/pro
  • 价格¥0.05/次
  • 说明:从机构字符串中提取一级机构和二级机构的 ID推荐用于工作流

请求参数:

参数名 类型 必填 说明
org string 机构名称

响应字段:

字段名 说明
一级 一级机构名称
一级ID 一级机构 ID
二级 二级机构名称
二级ID 二级机构 ID
Total / total 总数

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/na/pro' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"org": "Department of Computer Science, Tsinghua University"}'

期刊类 API

23. 期刊搜索

  • URLPOST /api/venue/search
  • 价格:免费
  • 说明:根据期刊名称搜索期刊 ID 和标准名称

请求参数:

参数名 类型 必填 说明
name string 期刊名称(支持模糊搜索)

响应字段:

字段名 说明
id 期刊 ID
name_en 期刊英文名称
name_zh 期刊中文名称
total 总数

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/venue/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"name": "NeurIPS"}'

24. 期刊详情

  • URLPOST /api/venue/detail
  • 价格¥0.20/次
  • 说明:根据期刊 ID 获取 ISSN、简称、类型等详情

请求参数:

参数名 类型 必填 说明
id string 期刊 ID

响应字段:

字段名 说明
id 期刊 ID
name / name_en / name_zh 名称(原始/英文/中文)
issn ISSN
eissn EISSN
alias 别名
type 期刊类型

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/venue/detail' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"id": "<VENUE_ID>"}'

25. 期刊论文

  • URLPOST /api/venue/paper/relation
  • 价格¥0.10/次
  • 说明:根据期刊 ID 获取论文列表(支持按年份筛选)

请求参数:

参数名 类型 必填 说明
id string 期刊 ID
offset number 起始位置
limit number 返回条数
year number 按年份筛选

响应字段:

字段名 说明
id 论文 ID
title 论文标题
year 年份
offset 当前偏移量
total 总数

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/venue/paper/relation' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"id": "<VENUE_ID>", "year": 2023, "offset": 0, "limit": 20}'

专利类 API

26. 专利搜索

  • URLPOST /api/patent/search
  • 价格:免费
  • 说明:根据专利名称/关键词搜索专利

请求参数:

参数名 类型 必填 说明
query string 查询字段(专利标题/关键词)
page number 页数
size number 每页展示条数

响应字段:

字段名 说明
id 专利 ID
title 专利英文标题
title_zh 专利中文标题

curl 示例:

curl -X POST \
  'https://datacenter.aminer.cn/gateway/open_platform/api/patent/search' \
  -H 'Content-Type: application/json;charset=utf-8' \
  -H 'Authorization: <TOKEN>' \
  -d '{"query": "量子计算芯片", "page": 0, "size": 10}'

27. 专利信息

  • URLGET /api/patent/info
  • 价格:免费
  • 说明:根据专利 ID 获取基础信息(标题、专利号、发明人、国家)

请求参数:

参数名 类型 必填 说明
id string 专利 ID

响应字段:

字段名 说明
id 专利 ID
title / en 专利标题(英文)
app_num 申请号
pub_num 发布号
pub_kind 发布类型
inventor 发明人
country 国家
sequence 顺序

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/patent/info?id=<PATENT_ID>' \
  -H 'Authorization: <TOKEN>'

28. 专利详情

  • URLGET /api/patent/detail
  • 价格¥0.01/次
  • 说明:根据专利 ID 获取完整详情含摘要、申请日、受让人、IPC 分类等)

请求参数:

参数名 类型 必填 说明
id string 专利 ID

响应字段:

字段名 说明
id 专利 ID
title 专利标题
abstract 摘要
app_date 申请日期
app_num 申请号
pub_date 公开日期
pub_num 公开号
pub_kind 公开类型
assignee 受让人
inventor 发明人
country 国别
ipc IPC 分类号
ipcr IPCR 分类号
cpc CPC 分类号
priority 优先权信息
description 说明书

curl 示例:

curl -X GET \
  'https://datacenter.aminer.cn/gateway/open_platform/api/patent/detail?id=<PATENT_ID>' \
  -H 'Authorization: <TOKEN>'

附录API 价格汇总

类别 免费接口 收费接口
论文 论文搜索、论文信息 论文搜索pro(¥0.01)、论文详情(¥0.01)、论文引用(¥0.10)、论文问答搜索(¥0.05)、论文搜索接口(¥0.30)、论文批量查询(¥0.10)、按条件获取(¥0.20)
学者 学者搜索 学者详情(¥1.00)、学者画像(¥0.50)、学者论文(¥1.50)、学者专利(¥1.50)、学者项目(¥3.00)
机构 机构搜索 机构详情(¥0.01)、机构学者(¥0.50)、机构论文(¥0.10)、机构专利(¥0.10)、机构消歧(¥0.01)、机构消歧pro(¥0.05)
期刊 期刊搜索 期刊详情(¥0.20)、期刊论文(¥0.10)
专利 专利搜索、专利信息 专利详情(¥0.01)