超能文献学术文献检索 API#

超能文献（Suppr）提供基于 PubMed 的 AI 语义文献检索服务，支持自然语言查询和丰富的文献元数据返回。

• API 基础地址： https://api.suppr.wilddata.cn
• API 文档： https://openapi.suppr.wilddata.cn/introduction.html
• 认证方式： Authorization: Bearer <your_api_key>

何时激活#

• 用户需要检索学术论文或文献
• 用户需要搜索 PubMed 数据库
• 用户需要查找特定主题的研究资料
• 用户需要获取论文的 DOI、PMID、影响因子等元数据

API 端点#

语义文献检索#

text

POST https://api.suppr.wilddata.cn/v1/docs/semantic_search
Content-Type: application/json
Authorization: Bearer <your_api_key>

请求体参数：

参数类型必填默认值说明queryString是-自然语言查询字符串topkInteger否20最大返回结果数量，范围 1-100return_doc_keysString[]否[]指定返回的文献字段列表auto_selectBoolean否true是否由 AI 自动选择最优结果

return_doc_keys 完整字段列表#

字段说明title标题link链接snippet检索条目内容片段/摘要datetime时间abstract论文摘要doi数字对象标识符 DOIelocation_doi电子定位符 DOIpii出版商项目标识符 PIIelocation_pii电子定位符 PIIcited_by_num被引用次数pub_year出版年份pub_season出版季pub_month出版月份pub_day出版日issue_pub_year出版时间（期刊印刷版）issue_pub_season出版季（期刊印刷版）issue_pub_month出版月份（期刊印刷版）issue_pub_day出版日（期刊印刷版）article_pub_year出版年份（电子版）article_pub_season出版季（电子版）article_pub_month出版月份（电子版）article_pub_day出版日（电子版）publication出版物publication_abbr出版物缩写publication_nlm_id出版物 NLM IDp_issn纸质版 ISSNe_issn电子版 ISSNl_issn链接 ISSNimpact_factor影响因子publisher出版商publisher_abbr出版商（缩写）publisher_location出版机构所在地pub_source_str出版源language语言（title/abstract/snippet）pub_language原出版语言i18n_infos国际化信息figure_ids图片 ID 列表figure_urls图片 URL 列表table_ids表格 ID 列表pmidPubMed IDpmcidPubMed Central IDpub_volume卷pub_issue期pub_page页码pub_start_page起始页码pub_end_page结束页码pub_model出版模式

常用字段组合#

快速概览#

json

{
  "query": "糖尿病最新研究进展",
  "topk": 10,
  "return_doc_keys": ["title", "abstract", "pub_year"],
  "auto_select": true
}

引用格式#

json

{
  "query": "CRISPR gene editing therapy",
  "topk": 20,
  "return_doc_keys": ["title", "doi", "pmid", "authors", "publication", "pub_year", "pub_volume", "pub_issue", "pub_page"],
  "auto_select": true
}

完整元数据#

json

{
  "query": "machine learning drug discovery",
  "topk": 5,
  "return_doc_keys": ["title", "abstract", "doi", "pmid", "pmcid", "impact_factor", "authors", "pub_year", "publication", "cited_by_num"],
  "auto_select": true
}

响应格式#

json

{
  "code": 0,
  "data": {
    "search_items": [
      {
        "doc": {
          "title": "论文标题",
          "abstract": "论文摘要...",
          "doi": "10.1007/xxxxx",
          "pmid": "35397038",
          "authors": [
            {
              "fore_name": "名",
              "last_name": "姓",
              "affiliations": [
                { "name": "所属机构" }
              ]
            }
          ],
          "publication": "期刊名称",
          "pub_year": 2024,
          "impact_factor": 5.2
        },
        "search_gateway": "pubmed"
      }
    ],
    "consumed_points": 20
  },
  "msg": ""
}

code 为 0 表示成功，非 0 表示错误。

使用示例#

bash

curl -X POST https://api.suppr.wilddata.cn/v1/docs/semantic_search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "阿尔茨海默病早期诊断生物标志物",
    "topk": 10,
    "return_doc_keys": ["title", "abstract", "doi", "pmid", "pub_year", "impact_factor"],
    "auto_select": true
  }'

注意事项#

• topk 为期望返回的最大数量，实际返回可能少于该值（取决于检索结果）
• 不指定 return_doc_keys 时返回默认字段集
• auto_select 为 true 时，AI 会自动筛选与查询最相关的结果
• 速率限制：60 次/分钟