---
title: "财经多源取证（公告 + 资讯 · 带证据指纹）"
method: GET
path: "/v1/evidence"
tags: ["pro"]
---

# 财经多源取证（公告 + 资讯 · 带证据指纹）

`GET /v1/evidence`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/evidence`
- Auth: none declared

**一次查询，多源取证**：同时检索**巨潮公告**（沪深两市，官方一手）与**东方财富资讯**，归一成同一张表，并把转载去重。

`data` 行字段：`source`（`cninfo` 公告 / `eastmoney` 资讯·研报）/ `kind`（`notice` 公告 / `news` 资讯 / `report` 研报）/ `title` / `url` / `date` / `code` / `name` / `media` / `authority`（1.0 官方 · 0.5 门户）/ `relevance`（1.0 命中实体 · 0.6 仅摘要命中 · 0.3 未能确认）/ `relevance_where`（`title` 标题有它 / `name` 主体名称有它 / `snippet` 只在摘要里 / `unknown`）/ `snippet`（正文摘要，**资讯才有**；公告正文在 PDF 里，此处为空）/ `also_on`（同一消息的其它转载，去重后归到这里）。
**每行还带证据三件套**：`cit_endpoint`（本端点地址）/ `cit_params`（请求参数）/ `cit_field_path`（行内字段，目前固定 `data.title`）/ `cit_value_hash`（值指纹）/ `cit_hash_alg`（指纹算法 `sha256-v1`）/ `cit_upstream`（数据来源的原接口，溯源用）/ `cit_retrieved_at`。
⭐ **指纹怎么核对（公式公开）**：拿 `cit_endpoint` + `cit_params` 重新请求 → 在结果里找到 `date` 与 `title` 都相同的那一行 → 计算 `sha256( endpoint | 按 key 排序的 k=v 用 & 连 | cit_field_path | JSON(标题) | 日期 )`，取前 **16** 位十六进制，应等于 `cit_value_hash`。
顶层 `meta`：`trace`（每步用了哪个源、耗时、状态）/ `counts`（各源命中数）/ `counts_kind`（各品类命中数 `/ 公告·资讯·研报`）/ `related`。

⭐ **它解决什么**：搜「宁德时代」，**公告和新闻一次拿到**，而不是自己在两个站翻；同一条消息被多家转载时**只出现一次**，转载方收在 `also_on` 里。
⭐ **排序就是「搜」该有的顺序**：`relevance` → `authority` → `date`。标题或主体名称里就有这个词的排前面；同级时**公告在资讯前面**。`relevance` 只看**词出现在哪个字段**（可核对的客观分档），不做语义猜测。
⚠️ **公告比新闻权威**：`authority` 1.0 vs 0.5。名额仍是**各源平分** —— 否则公告会被当日新闻全挤掉。
⭐ **加 `scope=report` 可一并要研报**：标题 + 券商（`media`）+ 日期 + 原文链接。研报**单独算名额**，不会被资讯挤掉，也**不额外计费**。研报没有摘要，`snippet` 为空。
⚠️ 公告返回的是**PDF 链接**（巨潮原始披露），资讯返回的是**原文链接**，研报返回的是**研报详情页**链接。
⚠️ 结果缓存 5 分钟；`scope` 可选 `notice` / `news` / `report`，逗号分隔（默认 `notice,news`）。

## Query parameters

- `q` string, required: 检索词：宁德时代 / 贵州茅台 / 三季度业绩
- `scope` string: 范围：notice 公告 / news 资讯 / report 研报，逗号分隔
- `limit` integer: 返回条数（各源平分名额）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)