Back to Details

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.
27个API + 5个工作流。需要Token：设置
AMINER_API_KEY
环境变量。

Mandatory Rules (Critical)

强制规则（重要）

  1. Token Security: Only check whether 
    AMINER_API_KEY
    exists; never expose the token in plain text anywhere.
  2. 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.
  3. Free-First: Prefer free APIs unless the user explicitly requires deeper fields; only upgrade to paid APIs when free ones cannot satisfy the need.
  4. Result Links: Always append an accessible URL after each entity in the output.
  5. 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
    .
  6. 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)
    .
  7. 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}
  1. Token安全：仅检查
    AMINER_API_KEY
    是否存在，绝对不要在任何位置明文暴露Token。
  2. 成本控制：优先选择最优组合查询，不要无差别拉取全量详情。用户未指定数量时默认返回前10条详情。
  3. 免费优先：除非用户明确要求更深层字段，否则优先使用免费API，仅当免费API无法满足需求时再升级到付费API。
  4. 结果链接：输出时每个实体后必须追加可访问的URL。
  5. 歧义消除：学者信息歧义→通过
    org
    /
    org_id
    过滤，或询问用户确认。机构信息歧义→使用
    org_disambiguate_pro
    。论文信息歧义→交叉核对
    year
    +
    venue_name
    +
    first_author
    。
  6. 成本报告：完成所有API调用后，必须向用户输出成本汇总，展示内容包括：调用的每个API、单价、调用次数、总成本。格式示例：
    [成本] 总计¥X.XX，共N次API调用（api_a: ¥X.XX × N, api_b: 免费 × N）
    。
  7. 高成本确认（≥¥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

调用护栏

  1. Parameter names and types must match 
    references/api-catalog.md
    exactly.
  2. paper_info
    is batch-only: 
    {"ids": [...]}
    . 
    paper_detail
    is single-paper only: one 
    id
    . Never mix them.
  3. When multiple details are needed, filter with a low-cost API first, then fetch details for a small set.
  1. 参数名称和类型必须完全匹配
    references/api-catalog.md
    中的定义。
  2. paper_info
    仅支持批量调用：
    {"ids": [...]}
    。
    paper_detail
    仅支持单篇论文查询：传入单个
    id
    ，不要混用两个接口。
  3. 需要查询多个详情时，先用低成本API过滤，再针对小范围结果拉取详情。

Paper Search API Selection Guide

论文搜索API选择指南

When the user says "search for papers", determine the goal first:
APIFocusUse CaseCost
paper_search
Title search → 
paper_id
Known paper title, locate targetFree
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 searchSemantic search, structured keyword OR/AND¥0.05
paper_list_by_keywords
Multi-keyword batch retrievalBatch thematic retrieval¥0.10
paper_detail_by_condition
Year + venue dimensionJournal annual monitoring¥0.20
Default routing:
  1. Known title: 
    paper_search -> paper_detail -> paper_relation
  2. Conditional filtering: 
    paper_search_pro -> paper_detail
  3. Natural language Q&A: 
    paper_qa_search
    (fall back to 
    paper_search_pro
    if no results)
  4. 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
默认路由规则：
  1. 已知标题：
    paper_search -> paper_detail -> paper_relation
  2. 条件过滤查询：
    paper_search_pro -> paper_detail
  3. 自然语言问答：
    paper_qa_search
    （无结果时回退到
    paper_search_pro
    ）
  4. 期刊年度分析：
    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:
  1. Read 
    references/api-catalog.md
    to confirm available APIs, parameters, and response fields.
  2. Design the shortest viable call chain: locate ID → supplement details → expand relationships.
  3. Do not give up because "no existing workflow fits"; actively compose APIs based on 
    api-catalog
    .
当用户请求不在5个预设工作流范围内时：
  1. 查阅
    references/api-catalog.md
    确认可用API、参数和返回字段。
  2. 设计最短可行调用链：定位ID→补充详情→扩展关联关系。
  3. 不要因为「没有匹配的现有工作流」就拒绝请求，可基于
    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
#TitleMethodPriceAPI Path (Base: datacenter.aminer.cn/gateway/open_platform)
1Paper QA SearchPOST¥0.05
/api/paper/qa/search
2Scholar SearchPOSTFree
/api/person/search
3Paper SearchGETFree
/api/paper/search
4Paper Search ProGET¥0.01
/api/paper/search/pro
5Patent SearchPOSTFree
/api/patent/search
6Org SearchPOSTFree
/api/organization/search
7Venue SearchPOSTFree
/api/venue/search
8Scholar DetailsGET¥1.00
/api/person/detail
9Scholar ProjectsGET¥1.50
/api/project/person/v3/open
10Scholar PapersGET¥1.50
/api/person/paper/relation
11Scholar PatentsGET¥1.50
/api/person/patent/relation
12Scholar PortraitGET¥0.50
/api/person/figure
13Paper InfoPOSTFree
/api/paper/info
14Paper DetailsGET¥0.01
/api/paper/detail
15Paper CitationsGET¥0.10
/api/paper/relation
16Patent InfoGETFree
/api/patent/info
17Patent DetailsGET¥0.01
/api/patent/detail
18Org DetailsPOST¥0.01
/api/organization/detail
19Org PatentsGET¥0.10
/api/organization/patent/relation
20Org ScholarsGET¥0.50
/api/organization/person/relation
21Org PapersGET¥0.10
/api/organization/paper/relation
22Venue DetailsPOST¥0.20
/api/venue/detail
23Venue PapersPOST¥0.10
/api/venue/paper/relation
24Org DisambiguationPOST¥0.01
/api/organization/na
25Org Disambiguation ProPOST¥0.05
/api/organization/na/pro
26Paper Batch QueryGET¥0.10
/api/paper/list/citation/by/keywords
27Paper Details by Year+VenueGET¥0.20
/api/paper/platform/allpubs/more/detail/by/ts/org/venue
完整参数文档：查阅
references/api-catalog.md
#名称请求方法价格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

参考资料