CMA 中华医学会文献检索 API

通过中华医学会 Yiigle 官方网关检索中文医学文献，覆盖《中华内科杂志》《中华消化内镜杂志》等核心中文医学刊源。返回字段统一映射为 SearchResponse，与 Google Scholar / PubMed / 万方数据保持一致。

POST/v1/cma/search

CMA 文献检索

POST/v1/cma/search

提交中英文医学关键词调用中华医学会 Yiigle 网关，支持作者、期刊、年份范围过滤。网关仅识别 YYYY 年份格式，YYYY-MM / YYYY-MM-DD 等会被自动规整为年份。

参数

参数	类型	必填	描述
`query`	string	必填	搜索关键词（中英文均可），1-300 字符
`size`	integer	可选 (默认: 20)	返回结果数量，1-50，默认 20
`page`	integer	可选 (默认: 0)	分页页码（从 0 开始），默认 0
`author`	string	可选	按作者姓名过滤（可选）
`journal`	string	可选	按期刊名称过滤（可选）
`date_from`	string	可选	起始年份过滤。接受 YYYY / YYYY-MM / YYYY-MM-DD —— 非年份输入会自动规整为 YYYY
`date_to`	string	可选	截止年份过滤，规则同 date_from
`sort`	string	可选	排序表达式（默认 'artPubYear:desc;artId:desc'，按发表年份倒序）

响应

Response

{
  "success": true,
  "message": "CMA search completed successfully",
  "query": "高血压",
  "results": {
    "total": 10,
    "source": "CMA"
  },
  "data": [
    {
      "source": "CMA",
      "title": "原发性高血压的临床诊治进展",
      "authors": [
        "张三",
        "李四"
      ],
      "abstract": "本研究系统综述了原发性高血压的诊断与治疗进展……",
      "publication_year": "2024",
      "publication_journal": "中华心血管病杂志",
      "id": "1004-xxxx-xxxxxx",
      "doi": "10.3760/cma.j.cn112148-20240101-00001",
      "source_url": "https://rs.yiigle.com/cmaid/12345",
      "categories": [
        "高血压",
        "心血管疾病",
        "诊治"
      ],
      "volume": "52",
      "issue": "3",
      "pages": "210-217"
    }
  ]
}

响应字段说明

/v1/cma/search响应格式: JSON

字段	类型	说明
`success`	boolean	检索是否成功。
`message`	string	检索结果摘要。
`query`	string	实际执行的检索词。
`results.total`	integer	本次返回的论文数量。
`results.source`	string	论文来源平台。
`data`	Paper[]	标准化论文结果列表。
`data[].source`	string	来源，如 Google、Wanfang、PubMed、ArXiv。
`data[].title`	string	论文标题。
`data[].authors`	string[]	作者姓名列表。
`data[].abstract`	string \| null	摘要或检索结果片段。
`data[].publication_year`	integer \| string \| null	发表年份。
`data[].publication_journal`	string \| null	期刊或会议名称。
`data[].id`	string \| null	来源平台中的论文标识。
`data[].doi`	string \| null	数字对象唯一标识符。
`data[].source_url`	string \| null	论文来源页面。
`data[].pdf_url`	string \| null	可用时的 PDF 直链。
`data[].categories`	string[]	主题分类或关键词。
`data[].cited_by_count`	integer \| null	引用次数。
`data[].cited_by_link`	string \| null	引用该论文的文献列表链接。
`data[].mesh_terms`	string[]	PubMed 的 MeSH 主题词。
`data[].primary_category`	string \| null	ArXiv 主分类。
`data[].published_date`	string \| null	ArXiv 完整发表日期。
`data[].updated_date`	string \| null	ArXiv 最近更新日期。
`data[].pmc_id`	string \| null	PubMed Central 标识。
`data[].publication_types`	string[]	PubMed 文献类型。
`data[].keywords`	string[]	关键词列表。
`data[].volume / issue / pages`	string \| null	卷、期和页码。

响应

Response

{
  "success": true,
  "message": "CMA search completed successfully",
  "query": "高血压",
  "results": {
    "total": 10,
    "source": "CMA"
  },
  "data": [
    {
      "source": "CMA",
      "title": "原发性高血压的临床诊治进展",
      "authors": [
        "张三",
        "李四"
      ],
      "abstract": "本研究系统综述了原发性高血压的诊断与治疗进展……",
      "publication_year": "2024",
      "publication_journal": "中华心血管病杂志",
      "id": "1004-xxxx-xxxxxx",
      "doi": "10.3760/cma.j.cn112148-20240101-00001",
      "source_url": "https://rs.yiigle.com/cmaid/12345",
      "categories": [
        "高血压",
        "心血管疾病",
        "诊治"
      ],
      "volume": "52",
      "issue": "3",
      "pages": "210-217"
    }
  ]
}

示例

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.qinyanai.com"

# CMA literature search (中华医学会 Yiigle)
response = requests.post(
    f"{BASE_URL}/v1/cma/search",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "query": "高血压",
        "size": 10,
        "page": 0,
        "date_from": "2020",
        "date_to": "2025"
    }
)
data = response.json()
for paper in data["data"]:
    print(f"{paper['title']} - {paper['publication_journal']} ({paper['publication_year']})")