Cyprex API

Citation Verify API

Verify academic citations against Google Scholar via ScrapingDog. Accepts citation strings and returns per-citation verification results with matched paper metadata and similarity scores.

POST/v1/citation-verify/verify

引文核验

POST/v1/citation-verify/verify

接受引文字符串列表（1-5 条），逐条在 Google Scholar 上搜索验证。返回结果类型：'verified'（精确匹配）、'mismatch'（找到但细节不同）或 'not_found'（未找到）。

参数

参数类型必填描述
citationsstring[]必填待验证的引文字符串数组（1-5 条）

结果类型

verified — 引文与 Google Scholar 记录匹配——标题、作者和年份一致

mismatch — 在 Google Scholar 上找到但部分细节不同

not_found — 在 Google Scholar 上未找到匹配的出版物

参数

参数类型必填描述
citationsstring[]必填待验证的引文字符串数组（1-5 条）

响应

Response
{
  "success": true,
  "message": "Verified 2 citations: 2 verified, 0 mismatch, 0 not found",
  "total": 2,
  "verified_count": 2,
  "mismatch_count": 0,
  "not_found_count": 0,
  "results": [
    {
      "index": 1,
      "input_citation": "LeCun, Y., Bengio, Y., & Hinton, G. (2015). Deep learning. Nature, 521(7553), 436-444.",
      "result": "verified",
      "title_similarity": 1,
      "matched_paper": {
        "title": "Deep learning",
        "authors": [
          "Y LeCun",
          "Y Bengio",
          "G Hinton"
        ],
        "year": "2015",
        "journal": "nature",
        "cited_by": 109429
      },
      "mismatch_fields": null,
      "message": "Citation verified — title, authors, and year match Google Scholar record"
    }
  ]
}

示例

import requests

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

response = requests.post(
    f"{BASE_URL}/v1/citation-verify/verify",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "citations": [
            "LeCun, Y., Bengio, Y., & Hinton, G. (2015). Deep learning. Nature, 521(7553), 436-444.",
            "Vaswani, A., et al. (2017). Attention Is All You Need. NeurIPS, 30."
        ]
    }
)
data = response.json()
print(f"Verified: {data['verified_count']}, Mismatch: {data['mismatch_count']}, Not found: {data['not_found_count']}")
for r in data["results"]:
    print(f"  [{r['result']}] {r['input_citation'][:60]}...")