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'（未找到）。

参数

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

结果类型

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

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

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

响应字段说明

/v1/citation-verify/verify响应格式: JSON

字段	类型	说明
`success`	boolean	批量验证是否完成。
`message`	string	验证结果摘要。
`total`	integer	提交的引文总数。
`verified_count / mismatch_count / not_found_count`	integer	已验证、不匹配和未找到的数量。
`results[]`	object[]	逐条验证结果。
`results[].index / input_citation`	integer / string	输入序号（从 1 开始）和原始引文。
`results[].result`	string	verified、mismatch 或 not_found。
`results[].title_similarity`	number \| null	标题匹配分数（0-1）。
`results[].matched_paper`	object \| null	匹配论文的标题、作者、年份、期刊、引用数及 URL。
`results[].mismatch_fields`	string[] \| null	不一致的字段名。
`results[].message`	string	本条结果的可读说明。

参数

参数	类型	必填	描述
`citations`	string[]	必填	待验证的引文字符串数组（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]}...")