超能文献学术文献检索 API

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

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

何时激活

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

API 端点

语义文献检索

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

请求体参数：

return_doc_keys 完整字段列表

常用字段组合

快速概览

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

引用格式

{
  "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
}

完整元数据

{
  "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
}

响应格式

{
  "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 表示错误。

使用示例

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 次/分钟