aminer-data-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AMiner Open Platform Academic Data Query

AMiner开放平台学术数据查询

27 APIs + 5 workflows. Token required: set

AMINER_API_KEY

env var.

Docs: https://open.aminer.cn/open/docs | Console: https://open.aminer.cn/open/board?tab=control

27个API + 5个工作流。需要Token：设置

AMINER_API_KEY

环境变量。

文档：https://open.aminer.cn/open/docs | 控制台：https://open.aminer.cn/open/board?tab=control

Mandatory Rules (Critical)

强制规则（重要）

Token Security: Only check whether
```
AMINER_API_KEY
```
exists; never expose the token in plain text anywhere.
Cost Control: Prefer optimal combined queries; never do indiscriminate full-detail retrieval. Default to top 10 details when the user has not specified a count.
Free-First: Prefer free APIs unless the user explicitly requires deeper fields; only upgrade to paid APIs when free ones cannot satisfy the need.
Result Links: Always append an accessible URL after each entity in the output.
Disambiguation: Scholar ambiguity → filter by
```
org
```
/
```
org_id
```
or ask user to confirm. Org ambiguity → use
```
org_disambiguate_pro
```
. Paper ambiguity → cross-check
```
year
```
+
```
venue_name
```
+
```
first_author
```
.
Cost Report: After completing all API calls, always output a cost summary to the user showing: each API called, its unit price, number of calls, and the total cost. Format example:
```
[Cost] ¥X.XX total, N API calls (api_a: ¥X.XX × N, api_b: Free × N)
```
.
High-Cost Confirmation (≥ ¥5): Before executing a workflow or call chain whose estimated total cost is ¥5.00 or more, stop and ask the user for confirmation first. Show the planned call chain, estimated cost per step, and the total. Only proceed after the user explicitly agrees. This applies to both predefined workflows (e.g., Scholar Profile ~¥6.00) and ad-hoc multi-step plans.

Entity URL templates (mandatory):

Paper:
```
https://www.aminer.cn/pub/{paper_id}
```

Scholar:

https://www.aminer.cn/profile/{scholar_id}

Patent:

https://www.aminer.cn/patent/{patent_id}

Journal:

https://www.aminer.cn/open/journal/detail/{journal_id}

Token安全：仅检查
```
AMINER_API_KEY
```
是否存在，绝对不要在任何位置明文暴露Token。
成本控制：优先选择最优组合查询，不要无差别拉取全量详情。用户未指定数量时默认返回前10条详情。
免费优先：除非用户明确要求更深层字段，否则优先使用免费API，仅当免费API无法满足需求时再升级到付费API。
结果链接：输出时每个实体后必须追加可访问的URL。
歧义消除：学者信息歧义→通过
```
org
```
/
```
org_id
```
过滤，或询问用户确认。机构信息歧义→使用
```
org_disambiguate_pro
```
。论文信息歧义→交叉核对
```
year
```
+
```
venue_name
```
+
```
first_author
```
。
成本报告：完成所有API调用后，必须向用户输出成本汇总，展示内容包括：调用的每个API、单价、调用次数、总成本。格式示例：
```
[成本] 总计¥X.XX，共N次API调用（api_a: ¥X.XX × N, api_b: 免费 × N）
```
。
高成本确认（≥¥5）：执行预估总成本≥5元的工作流或调用链前，必须先暂停并询问用户确认，展示计划调用链、每一步预估成本和总成本，仅当用户明确同意后再继续。此规则同时适用于预定义工作流（比如学者档案查询约¥6.00）和临时多步查询计划。

实体URL模板（强制使用）：

论文：
```
https://www.aminer.cn/pub/{paper_id}
```

学者：

https://www.aminer.cn/profile/{scholar_id}

专利：

https://www.aminer.cn/patent/{patent_id}

期刊：

https://www.aminer.cn/open/journal/detail/{journal_id}

Token Check (Required)

Token检查（必填）

Check

AMINER_API_KEY

exists before any API call. Never expose token in plain text.

bash

[ -z "${AMINER_API_KEY+x}" ] && echo "AMINER_API_KEY missing" || echo "AMINER_API_KEY exists"

If
```
${AMINER_API_KEY}
```
exists: proceed. If not: check
```
--token
```
parameter. If neither: stop, guide user to Console to generate one.
If the user provides
```
AMINER_API_KEY
```
inline (e.g. "My token is xxx"), accept it for the current session, but recommend setting it as an environment variable for better security.

Default headers:

Authorization: ${AMINER_API_KEY}

X-Platform: openclaw

Content-Type: application/json;charset=utf-8

(POST).

调用任何API前先检查

AMINER_API_KEY

是否存在，绝对不要明文暴露Token。

bash

[ -z "${AMINER_API_KEY+x}" ] && echo "AMINER_API_KEY missing" || echo "AMINER_API_KEY exists"

如果
```
${AMINER_API_KEY}
```
存在：继续执行。如果不存在：检查
```
--token
```
参数。如果两者都不存在：停止执行，引导用户到控制台生成Token。
如果用户直接提供
```
AMINER_API_KEY
```
（比如“我的Token是xxx”），当前会话可以接受，但建议用户设置为环境变量以提升安全性。

默认请求头：

Authorization: ${AMINER_API_KEY}

、

X-Platform: openclaw

、

Content-Type: application/json;charset=utf-8

（POST请求）。

Call Guardrails

调用护栏

Parameter names and types must match
```
references/api-catalog.md
```
exactly.
```
paper_info
```
is batch-only:
```
{"ids": [...]}
```
.
```
paper_detail
```
is single-paper only: one
```
id
```
. Never mix them.
When multiple details are needed, filter with a low-cost API first, then fetch details for a small set.

参数名称和类型必须完全匹配
```
references/api-catalog.md
```
中的定义。
```
paper_info
```
仅支持批量调用：
```
{"ids": [...]}
```
。
```
paper_detail
```
仅支持单篇论文查询：传入单个
```
id
```
，不要混用两个接口。
需要查询多个详情时，先用低成本API过滤，再针对小范围结果拉取详情。

Paper Search API Selection Guide

论文搜索API选择指南

When the user says "search for papers", determine the goal first:

API	Focus	Use Case	Cost
`paper_search`	Title search → `paper_id`	Known paper title, locate target	Free
`paper_search_pro`	Multi-condition search (author/org/venue/keyword)	Topic search, sort by citations or year	¥0.01
`paper_qa_search`	Natural language Q&A / topic keyword search	Semantic search, structured keyword OR/AND	¥0.05
`paper_list_by_keywords`	Multi-keyword batch retrieval	Batch thematic retrieval	¥0.10
`paper_detail_by_condition`	Year + venue dimension	Journal annual monitoring	¥0.20

Default routing:

Known title:

paper_search -> paper_detail -> paper_relation

Conditional filtering:
```
paper_search_pro -> paper_detail
```
Natural language Q&A:
```
paper_qa_search
```
(fall back to
```
paper_search_pro
```
if no results)

Journal annual analysis:

venue_search -> venue_paper_relation -> paper_detail_by_condition

Key

paper_qa_search

rules:

```
query
```
and
```
topic_high/topic_middle/topic_low
```
are mutually exclusive; do not pass both.
```
query
```
mode: pass a natural language string.
```
topic_*
```
mode: expand synonyms/English variants first.

Supports

sci_flag

force_citation_sort

force_year_sort

author_id

org_id

venue_ids

filters.

Free-tier screening fields available:

paper_search

venue_name

first_author

n_citation_bucket

year

paper_info

abstract_slice

year

venue_id

author_count

person_search

interests

n_citation

org/org_id

```
organization_search
```
:
```
aliases
```
```
venue_search
```
:
```
aliases
```
,
```
venue_type
```

patent_search

inventor_name

app_year

pub_year

```
patent_info
```
:
```
app_year
```
,
```
pub_year
```

当用户说“搜索论文”时，先明确查询目标：

API	核心能力	适用场景	成本
`paper_search`	标题搜索→返回 `paper_id`	已知论文标题，定位目标论文	免费
`paper_search_pro`	多条件搜索（作者/机构/出版源/关键词）	主题搜索，按引用量或年份排序	¥0.01
`paper_qa_search`	自然语言问答/主题关键词搜索	语义搜索，结构化关键词OR/AND组合查询	¥0.05
`paper_list_by_keywords`	多关键词批量检索	批量主题检索	¥0.10
`paper_detail_by_condition`	年份+出版源维度查询	期刊年度内容监控	¥0.20

默认路由规则：

已知标题：

paper_search -> paper_detail -> paper_relation

条件过滤查询：
```
paper_search_pro -> paper_detail
```
自然语言问答：
```
paper_qa_search
```
（无结果时回退到
```
paper_search_pro
```
）

期刊年度分析：

venue_search -> venue_paper_relation -> paper_detail_by_condition

paper_qa_search

核心规则：

```
query
```
参数和
```
topic_high/topic_middle/topic_low
```
参数互斥，不要同时传入。
```
query
```
模式：传入自然语言字符串。
```
topic_*
```
模式：先扩展同义词/英文变体。

支持

sci_flag

、

force_citation_sort

、

force_year_sort

、

author_id

、

org_id

、

venue_ids

过滤参数。

免费层可用筛选字段：

paper_search

：

venue_name

、

first_author

、

n_citation_bucket

、

year

paper_info

：

abstract_slice

、

year

、

venue_id

、

author_count

person_search

：

interests

、

n_citation

、

org/org_id

```
organization_search
```
：
```
aliases
```
```
venue_search
```
：
```
aliases
```
、
```
venue_type
```

patent_search

：

inventor_name

、

app_year

、

pub_year

```
patent_info
```
：
```
app_year
```
、
```
pub_year
```

Handling Out-of-Workflow Requests

非工作流请求处理

When the user's request falls outside the 5 workflows:

Read
```
references/api-catalog.md
```
to confirm available APIs, parameters, and response fields.
Design the shortest viable call chain: locate ID → supplement details → expand relationships.
Do not give up because "no existing workflow fits"; actively compose APIs based on
```
api-catalog
```
.

当用户请求不在5个预设工作流范围内时：

查阅
```
references/api-catalog.md
```
确认可用API、参数和返回字段。
设计最短可行调用链：定位ID→补充详情→扩展关联关系。
不要因为「没有匹配的现有工作流」就拒绝请求，可基于
```
api-catalog
```
灵活组合API。

5 Combined Workflows

5个组合工作流

Workflow 1: Scholar Profile (~¥6.00)

工作流1：学者档案查询（约¥6.00）

Use Case: Complete academic profile — bio, research interests, papers, patents, projects. Cost note: Full execution exceeds the ¥5 threshold → must ask for user confirmation before proceeding (Rule 7). Show the planned steps and cost. Confirm which sub-modules are needed; skip patents/projects if not requested.

Call Chain:

Scholar search (name → person_id)
    ↓
Parallel calls (pick as needed):
  ├── Scholar details (bio/education/honors)         ¥1.00
  ├── Scholar portrait (interests/work history)      ¥0.50
  ├── Scholar papers (paper list)                    ¥1.50
  ├── Scholar patents (patent list)                  ¥1.50
  └── Scholar projects (funding info)                ¥1.50

Fallback: if

paper_search

yields no results in sub-steps, fall back to

paper_search_pro

适用场景：完整学术档案查询——个人简介、研究方向、论文、专利、项目。 成本提示：完整执行成本超过5元阈值→执行前必须询问用户确认（规则7），展示计划步骤和成本，确认需要的子模块，若用户不需要专利/项目可跳过对应步骤。

调用链：

学者搜索（姓名→person_id）
    ↓
并行调用（按需选择）：
  ├── 学者详情（个人简介/教育经历/荣誉）         ¥1.00
  ├── 学者画像（研究方向/工作经历）              ¥0.50
  ├── 学者论文（论文列表）                    ¥1.50
  ├── 学者专利（专利列表）                  ¥1.50
  └── 学者项目（资助信息）                ¥1.50

回退方案：如果子步骤中

paper_search

无结果，回退到

paper_search_pro

。

Workflow 2: Paper Deep Dive (~¥0.12)

工作流2：论文深度解析（约¥0.12）

Use Case: Full paper information and citation chain from a title or keyword.

Call Chain:

Paper search / Paper search pro (title/keyword → paper_id)
    ↓
Paper details (abstract/authors/DOI/journal/year/keywords)  ¥0.01
    ↓
Paper citations (cited papers → cited_ids)                  ¥0.10
    ↓
(Optional) Batch paper_info for cited papers                Free

Fallback: if

paper_search

yields no results, fall back to

paper_search_pro

适用场景：通过标题或关键词获取论文完整信息和引用链。

调用链：

论文搜索/论文高级搜索（标题/关键词→paper_id）
    ↓
论文详情（摘要/作者/DOI/期刊/年份/关键词）  ¥0.01
    ↓
论文引用关系（被引论文→cited_ids）                  ¥0.10
    ↓
（可选）批量调用paper_info获取被引论文详情                免费

回退方案：如果

paper_search

无结果，回退到

paper_search_pro

。

Workflow 3: Org Analysis (~¥0.81)

工作流3：机构分析（约¥0.81）

Use Case: Institution scholar size, paper output, patent count — for competitive research or partnership evaluation.

Call Chain:

Org disambiguation pro (raw string → org_id)  ¥0.05
    ↓
Parallel calls:
  ├── Org details (description/type)             ¥0.01
  ├── Org scholars (scholar list, 10/call)       ¥0.50
  ├── Org papers (paper list, 10/call)           ¥0.10
  └── Org patents (patent IDs, up to 10,000)     ¥0.10

If disambiguation pro returns no ID, fall back to
org_search
(free).

适用场景：机构学者规模、论文产出、专利数量查询——用于竞品调研或合作评估。

调用链：

机构高级消歧（原始字符串→org_id）  ¥0.05
    ↓
并行调用：
  ├── 机构详情（介绍/类型）             ¥0.01
  ├── 机构学者（学者列表，每次返回10条）       ¥0.50
  ├── 机构论文（论文列表，每次返回10条）           ¥0.10
  └── 机构专利（专利ID列表，最多10000条）     ¥0.10

如果高级消歧未返回ID，回退到
org_search
（免费）。

Workflow 4: Venue Papers (~¥0.10 - ¥0.30)

工作流4：出版源论文查询（约¥0.10 - ¥0.30）

Use Case: Track journal papers by year; useful for submission research or trend analysis.

Call Chain:

Venue search (name → venue_id)                          Free
    ↓
(Optional) Venue details (ISSN/type/abbreviation)       ¥0.20
    ↓
Venue papers (venue_id + year → paper_id list)          ¥0.10
    ↓
(Optional) Batch paper detail query

适用场景：按年度跟踪期刊论文，适合投稿调研或趋势分析。

调用链：

出版源搜索（名称→venue_id）                          免费
    ↓
（可选）出版源详情（ISSN/类型/缩写）       ¥0.20
    ↓
出版源论文查询（venue_id + 年份→paper_id列表）          ¥0.10
    ↓
（可选）批量论文详情查询

Workflow 5: Patent Analysis (~¥0.02)

工作流5：专利分析（约¥0.02）

Use Case: Search patents in a technology domain, or retrieve a scholar's/institution's patent portfolio.

Call Chain (standalone search):

Patent search (query → patent_id)        Free
    ↓
Patent info / Patent details             Free / ¥0.01

Call Chain (via scholar/institution):

Scholar search → Scholar patents (patent_id list)
Org disambiguation → Org patents (patent_id list)
    ↓
Patent info / Patent details

适用场景：搜索技术领域专利，或查询学者/机构的专利组合。

调用链（独立搜索）：

专利搜索（查询词→patent_id）        免费
    ↓
专利信息/专利详情             免费 / ¥0.01

调用链（通过学者/机构查询）：

学者搜索→学者专利（patent_id列表）
机构消歧→机构专利（patent_id列表）
    ↓
专利信息/专利详情

Individual API Quick Reference

单个API快速参考

Full parameter docs: read
references/api-catalog.md


/api/paper/qa/search
/api/person/search
/api/paper/search
/api/paper/search/pro
/api/patent/search
/api/organization/search
/api/venue/search
/api/person/detail
/api/project/person/v3/open
/api/person/paper/relation
/api/person/patent/relation
/api/person/figure
/api/paper/info
/api/paper/detail
/api/paper/relation
/api/patent/info
/api/patent/detail
/api/organization/detail
/api/organization/patent/relation
/api/organization/person/relation
/api/organization/paper/relation
/api/venue/detail
/api/venue/paper/relation
/api/organization/na
/api/organization/na/pro
/api/paper/list/citation/by/keywords
/api/paper/platform/allpubs/more/detail/by/ts/org/venue

#	Title	Method	Price	API Path (Base: datacenter.aminer.cn/gateway/open_platform)
1	Paper QA Search	POST	¥0.05	`/api/paper/qa/search`
2	Scholar Search	POST	Free	`/api/person/search`
3	Paper Search	GET	Free	`/api/paper/search`
4	Paper Search Pro	GET	¥0.01	`/api/paper/search/pro`
5	Patent Search	POST	Free	`/api/patent/search`
6	Org Search	POST	Free	`/api/organization/search`
7	Venue Search	POST	Free	`/api/venue/search`
8	Scholar Details	GET	¥1.00	`/api/person/detail`
9	Scholar Projects	GET	¥1.50	`/api/project/person/v3/open`
10	Scholar Papers	GET	¥1.50	`/api/person/paper/relation`
11	Scholar Patents	GET	¥1.50	`/api/person/patent/relation`
12	Scholar Portrait	GET	¥0.50	`/api/person/figure`
13	Paper Info	POST	Free	`/api/paper/info`
14	Paper Details	GET	¥0.01	`/api/paper/detail`
15	Paper Citations	GET	¥0.10	`/api/paper/relation`
16	Patent Info	GET	Free	`/api/patent/info`
17	Patent Details	GET	¥0.01	`/api/patent/detail`
18	Org Details	POST	¥0.01	`/api/organization/detail`
19	Org Patents	GET	¥0.10	`/api/organization/patent/relation`
20	Org Scholars	GET	¥0.50	`/api/organization/person/relation`
21	Org Papers	GET	¥0.10	`/api/organization/paper/relation`
22	Venue Details	POST	¥0.20	`/api/venue/detail`
23	Venue Papers	POST	¥0.10	`/api/venue/paper/relation`
24	Org Disambiguation	POST	¥0.01	`/api/organization/na`
25	Org Disambiguation Pro	POST	¥0.05	`/api/organization/na/pro`
26	Paper Batch Query	GET	¥0.10	`/api/paper/list/citation/by/keywords`
27	Paper Details by Year+Venue	GET	¥0.20	`/api/paper/platform/allpubs/more/detail/by/ts/org/venue`

完整参数文档：查阅
references/api-catalog.md


/api/paper/qa/search
/api/person/search
/api/paper/search
/api/paper/search/pro
/api/patent/search
/api/organization/search
/api/venue/search
/api/person/detail
/api/project/person/v3/open
/api/person/paper/relation
/api/person/patent/relation
/api/person/figure
/api/paper/info
/api/paper/detail
/api/paper/relation
/api/patent/info
/api/patent/detail
/api/organization/detail
/api/organization/patent/relation
/api/organization/person/relation
/api/organization/paper/relation
/api/venue/detail
/api/venue/paper/relation
/api/organization/na
/api/organization/na/pro
/api/paper/list/citation/by/keywords
/api/paper/platform/allpubs/more/detail/by/ts/org/venue

#	名称	请求方法	价格	API路径（基地址：datacenter.aminer.cn/gateway/open_platform）
1	论文问答搜索	POST	¥0.05	`/api/paper/qa/search`
2	学者搜索	POST	免费	`/api/person/search`
3	论文搜索	GET	免费	`/api/paper/search`
4	论文高级搜索	GET	¥0.01	`/api/paper/search/pro`
5	专利搜索	POST	免费	`/api/patent/search`
6	机构搜索	POST	免费	`/api/organization/search`
7	出版源搜索	POST	免费	`/api/venue/search`
8	学者详情	GET	¥1.00	`/api/person/detail`
9	学者项目	GET	¥1.50	`/api/project/person/v3/open`
10	学者论文	GET	¥1.50	`/api/person/paper/relation`
11	学者专利	GET	¥1.50	`/api/person/patent/relation`
12	学者画像	GET	¥0.50	`/api/person/figure`
13	论文信息	POST	免费	`/api/paper/info`
14	论文详情	GET	¥0.01	`/api/paper/detail`
15	论文引用关系	GET	¥0.10	`/api/paper/relation`
16	专利信息	GET	免费	`/api/patent/info`
17	专利详情	GET	¥0.01	`/api/patent/detail`
18	机构详情	POST	¥0.01	`/api/organization/detail`
19	机构专利	GET	¥0.10	`/api/organization/patent/relation`
20	机构学者	GET	¥0.50	`/api/organization/person/relation`
21	机构论文	GET	¥0.10	`/api/organization/paper/relation`
22	出版源详情	POST	¥0.20	`/api/venue/detail`
23	出版源论文	POST	¥0.10	`/api/venue/paper/relation`
24	机构消歧	POST	¥0.01	`/api/organization/na`
25	机构高级消歧	POST	¥0.05	`/api/organization/na/pro`
26	论文批量查询	GET	¥0.10	`/api/paper/list/citation/by/keywords`
27	按年份+出版源查询论文详情	GET	¥0.20	`/api/paper/platform/allpubs/more/detail/by/ts/org/venue`

References

参考资料

Full API parameter documentation: read
```
references/api-catalog.md
```
Optional Python client:
```
scripts/aminer_client.py
```
Test cases:
```
evals/evals.json
```
Official documentation: https://open.aminer.cn/open/docs
Console: https://open.aminer.cn/open/board?tab=control

完整API参数文档：查阅
```
references/api-catalog.md
```
可选Python客户端：
```
scripts/aminer_client.py
```
测试用例：
```
evals/evals.json
```
官方文档：https://open.aminer.cn/open/docs
控制台：https://open.aminer.cn/open/board?tab=control