系列「每天一个高质量 API」第 12 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 PubMed 文献检索(NCBI)(health-pubmed-search)。
570 万条生物医学文献索引:一次 esearch 拿到 PMID 列表,再按 ID 取标题与摘要,循证问答的第一步。
这个 API 能做什么
NCBI E-utilities 的 esearch 接口,db=pubmed 锁定 PubMed 库;term 支持布尔逻辑与 MeSH 主题词;retmode=json 返回结构化结果。核心字段:count(命中总数)、idlist(PMID 数组)、querytranslation(NCBI 实际执行的检索式)。
为什么 AI Agent 需要它
- 循证医学 Agent:先用 esearch 缩小范围,再用 esummary / efetch 取标题、作者、摘要。
- 稳定主键:PMID 是文献的永不变 ID,适合做去重与引用溯源。
- 可解释:
querytranslation告诉你 NCBI 把你的自然语言解析成了什么,便于调检索式。
怎么用
方式一:直连上游(免费、无需 Key)
curl "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?db=pubmed&term=cancer&retmode=json&retmax=3"
方式二:经搜蚁智选一键调用(带 Key,统一计费 / 限流 / 可观测)
curl -X POST https://souyi.net.cn/api/v1/ai/request \
-H "X-API-Key: YOUR_AIMALL_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"health-pubmed-search","call_data":{}}'
这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。
返回示例
{
"header": { "type": "esearch", "version": "0.3" },
"esearchresult": {
"count": "5724501",
"retmax": "3",
"retstart": "0",
"idlist": ["42896174", "42896168", "42896162"]
}
}
价格
免费。NCBI 无需 Key,默认限速 3 req/s(带 tool 与 email 参数可提到 10 req/s)。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 22 个)。
小结
PubMed 是医学 Agent 绕不过去的一站。esearch 负责「找到」,esummary/efetch 负责「读懂」,两步就能把循证链路串起来。
更多免费 API 见 系列目录。