接口文档 · 矿脉 VEIN

面向 AI Agent 的产业事实检索接口。全部为 GET 请求,返回 JSON。鉴权用 Authorization: Bearer <KEY>,免费 Key 在 申请页 领取。

项目值
Base URLhttps://cloud.ygwws.xyz
鉴权Authorization: Bearer <KEY>
返回格式JSON(UTF-8)
限流按 Key 每日限额,超限返回 429
OpenAPIopenapi.json(可直接导入 Postman / 代码生成器)

检索

GET/v1/search — 检索(含无答案检测)

检索(含无答案检测)。返回:命中返回 results 数组,每条带 url/title/snippet;无合适结果返回 found=false

参数类型必填说明
qstring否查询词,支持中英文
limitinteger否返回条数,默认 10,最大 50
allow_externalinteger否是否允许库外兜底(默认 0 不兜底)

真实返回摘录(2026-11-21 实测):

{"query": "冷轧钢卷", "results": [{"id": 13417, "title": "2026全球马口铁行业:你的成本模型里有没有把“贸易摩擦”和“航运风险”算进去?", "url": "https://www.chinairn.com/hyzx/20261117/171827827.shtml", "snippet": "…着晃”的品类。它的下游是食品罐头、饮料、奶粉,这些东西的流向跟贸易政策、汇率、航运安全绑得死死的。上游是冷轧钢带,钢价的每一次波动、每一轮反倾销调查,都会沿着", "published": "2026-11-17", "lang": "zh", "title_zh": null, "authority": 0.35, "score": 0.3101, "fresh": 0.9476, "title_hit": 0.0, "cos": 0.0, "term_hit": 1.0, "engines": ["own-index"], "thumb": "https://www.chinairn.com/Template/20240528Moban/image/2024-shoujiban.png", "source": "www.chinairn.com", "chars": 3468, "facts": []}], "meta": {"count": 1, "found": true, "latency_ms": 5925, "backend": "own-index"}}

GET/v1/research — 多步检索并汇总(研究模式)

多步检索并汇总(研究模式)。返回:返回多段证据 + 汇总,每段带出处

参数类型必填说明
qstring否研究主题
depthinteger否检索深度 1-3

GET/v1/extract — 从指定 URL 抽取结构化内容

从指定 URL 抽取结构化内容。返回:返回正文、标题、发布时间;抽取失败返回 error

参数类型必填说明
urlstring否要抽取的页面 URL

GET/v2/index_search — 库内全文检索(FTS5)

库内全文检索(FTS5)。返回:返回库内匹配的文档与片段

参数类型必填说明
qstring否查询词
limitinteger否返回条数

GET/v1/schema/fields — 字段字典

字段字典。返回:所有字段的名称、类型、单位、含义。单位换算(crore/billion)在这里说明,Agent 必读

结构化事实

GET/v2/facts — 结构化事实(带原文证据句)

结构化事实(带原文证据句)。返回:每条含 company/amount/currency/unit/capacity/location + evidence_* 原文句

参数类型必填说明
min_amountnumber否最小金额(原币数值)
conflictsinteger否只看数值有冲突的记录,1/0
limitinteger否返回条数

真实返回摘录(2026-11-21 实测):

{"query": {"q": null, "company": null, "country": null, "industry": null, "min_amount": null, "conflicts": false, "has_amount": false, "source_type": "media,official,press_release", "limit": 2, "offset": 0}, "count": 2, "total": 203, "results": [{"id": 114, "source_id": 3038, "title": "Industry Body FICCI Seeks Dedicated Lender For Manufacturing, Says Sector Needs Rs 100 Lakh Crore In Loans Over 10 Years", "url": "https://swarajyamag.com/news-brief/industry-body-ficci-seeks-dedicated-lender-for-manufacturing-says-sector-needs-rs-100-lakh-crore-in-loans-over-10-years", "country": "IN", "industry": "other", "company": "FICCI", "project": "manufacturing-focused development finance institution (DFI)", "amount": 100.0, "currency": "INR", "unit": "lakh crore", "amount_normalised": 100000000000000.0, "capacity": null, "capacity_unit": null, "location": null, "event_date": null, "evidence": "{\"company\": \"FICCI has also suggested a Strategic Manufacturing Capacity Development Programme to cut reliance on imports.\", \"project\": \"It has pitched a manufacturing-focused development finance institution (DFI) to offer long-tenure loans at competitive rates for capital-heavy projects.\", \"a …(截断)

GET/v2/structured — 结构化抽取(指定 URL 或文本)

结构化抽取(指定 URL 或文本)。返回:返回字段化的抽取结果 + 证据

参数类型必填说明
urlstring否页面 URL
textstring否或直接给正文文本

GET/v2/facts/stats — 事实库统计

事实库统计。返回:总量、按币种分布、冲突数、覆盖率

真实返回摘录(2026-11-21 实测):

{"total": 203, "with_amount": 126, "with_capacity": 78, "with_both": 48, "amount_conflicts": 41, "capacity_conflicts": 51, "by_industry": {"energy": 63, "construction": 32, "other": 27, "electron": 16, "auto": 15, "food": 15, "mining": 15, "steel": 12, "cement": 3, "chem": 3, "textile": 2}, "by_country": {"": 70, "IN": 70, "MX": 14, "BR": 13, "XX": 12, "ID": 8, "JP": 7, "US": 4, "GB": 3, "CN": 2}, "by_source_type": {"null": 146, "media": 57}, "top_by_amount": [{"company": "FICCI", "amount": 100.0, "unit": "lakh crore", "currency": "INR", "amount_normalised": 100000000000000.0, "location": null, "title": "Industry Body FICCI Seeks Dedicated Lender For Manufacturing, Says Sector Needs Rs 100 Lakh Crore In Loans Over 10 Years"}, {"company": null, "amount": 32.49, "unit": "lakh crore", "currency": "INR", "amount_normalised": 32490000000000.004, "location": "Andhra Pradesh", "title": "Rs 32.5 lakh cr investment intent later, why CM Naidu says he 'isn't happy yet'"}, {"company": "住房城乡建设部", "amount": 57215.0, "unit": "亿", "currency": "CNY", "amount_normalised": 5721500000000.0, "location": "全国", "title": "2026年1—10月份全国房地产市场基本情况"}, {"company": "NITI Aayog", "amount": 2.4, "unit": "lakh cro …(截断)

GET/v2/brief — 当日简报

当日简报。返回:返回多源事件 + 结构化事实,可直接喂给模型

参数类型必填说明
datestring否日期,默认今天

资讯与全文

GET/v2/news — 按日期/国家/来源查资讯

按日期/国家/来源查资讯。返回:返回 news 记录数组(标题、摘要、来源、发布时间、url)

参数类型必填说明
countrystring否两位国家码
sourcestring否来源域名,支持子串
datestring否发布日期 YYYY-MM-DD
limitinteger否返回条数

真实返回摘录(2026-11-21 实测):

{"query": {"q": null, "country": null, "lang": null, "source": null, "since": null, "until": null, "limit": 2, "offset": 0}, "count": 2, "results": [{"id": 21312, "title": "Chinese bearing maker commits initial $87-M investment in Batangas plant - Philippine News Agency", "summary": "Chinese bearing maker commits initial $87-M investment in Batangas plant Philippine News Agency", "url": "https://news.google.com/rss/articles/CBMipAFBVV95cUxPZUo1SmhIVUJxNnUwUlFhYmp2QWdZUHFMODYtdE5id3NMYjJVOS1uVjJCcnZtUW5fbFo1SFQ4bFRUTi1IRWNyb0dTd3kzbmMzQkxFcDgtNWhtQnY4U2dQWmpGRDUxMUZmaUthQXRLU3Q0cVNQU3BidE0xVFhmUmhiUUh4ZUlnS1ZVcVBvZzViTV8wVHBMWlBoakxVcEFPSWdyUlZScg?oc=5", "source_domain": "www.pna.gov.ph", "source_name": "Philippine News Agency", "lang": "en-US", "country": "US", "published": "2026-11-20", "fetched_at": "2026-11-20T21:20:05.598580+00:00"}, {"id": 21310, "title": "Vietnam shifts FDI focus from jobs and factories to technology - Nikkei Asia", "summary": "Vietnam shifts FDI focus from jobs and factories to technology Nikkei Asia", "url": "https://news.google.com/rss/articles/CBMiqwFBVV95cUxOMjR2cVhoaENUUjRaNDRoWl9MOFFwazF2akNBSFJ4TkdSNE4yQkVtOWlfODVDVXo0Y3Bua3YydkF0bE0tUlNyXzcyMnFiTkhvT …(截断)

GET/v2/news/stats — 资讯量统计

资讯量统计。返回:按天/国家的条目数

GET/v2/fulltext — 取正文全文

取正文全文。返回:返回我们抓取时保存的正文;原文付费墙或无正文时该条不返回

参数类型必填说明
urlstring否原文 URL(精确匹配)
limitinteger否返回条数

GET/v2/fulltext/stats — 全文覆盖率

全文覆盖率。返回:全文池总量、有正文的比例、按来源分布

索引与统计

GET/v2/index_stats — 索引统计

索引统计。返回:文档总量、向量维度、更新时间

真实返回摘录(2026-11-21 实测):

{"docs": 19617, "usable": 19610, "with_thumb": 9109, "updated_at": "2026-11-21T20:03:13", "growth": {"today_new": 450, "by_day": [{"day": "2026-11-21", "new": 450}, {"day": "2026-11-20", "new": 1552}, {"day": "2026-11-19", "new": 1649}, {"day": "2026-11-18", "new": 1847}, {"day": "2026-11-17", "new": 1608}, {"day": "2026-11-16", "new": 1558}, {"day": "2026-11-15", "new": 658}], "by_source": [{"source": "巨潮资讯", "docs": 9466}, {"source": "www.chinanews.com.cn", "docs": 2938}, {"source": "www.ithome.com", "docs": 1665}, {"source": "www.chinanews.com", "docs": 618}, {"source": "www.afzhan.com", "docs": 445}, {"source": "www.ne21.com", "docs": 440}, {"source": "www.gkzhan.com", "docs": 419}, {"source": "www.chinairn.com", "docs": 321}, {"source": "www.ccement.com", "docs": 269}, {"source": "www.cqn.com.cn", "docs": 249}]}, "top_hosts": [{"host": "static.cninfo.com.cn", "count": 9466}, {"host": "www.chinanews.com.cn", "count": 2938}, {"host": "www.ithome.com", "count": 1665}, {"host": "www.chinanews.com", "count": 618}, {"host": "www.afzhan.com", "count": 445}, {"host": "www.ne21.com", "count": 440}, {"host": "www.gkzhan.com", "count": 419}, {"host": "www.chinairn.com", "count": 321}, {" …(截断)

GET/v2/query_stats — 查询量统计

查询量统计。返回:近 N 日查询次数与热门词

账户

GET/v1/signup — 自助领取 API Key

自助领取 API Key。返回:返回 key 与每日限额;同一邮箱重复领取返回已有 key

参数类型必填说明
emailstring否邮箱(用于找回与用量通知)

GET/v1/me — 查询当前 Key 的用量与限额

查询当前 Key 的用量与限额。返回:返回本 key 的今日已用、每日上限、套餐

真实返回摘录(2026-11-21 实测):

{"plan": "free", "limit": 1000, "used": 9, "remaining": 991, "license": {"id": "LicenseRef-DTL-1.0", "version": "1.0", "url": "https://cloud.ygwws.xyz/licenses.html", "consent": {"accepted_at": "2026-11-12T03:11:20", "accepted_by": "legacy:DTL 发布前已签发(系统迁移补登)"}}, "today_by_path": [{"path": "/v2/facts/stats", "calls": 3}, {"path": "/v1/me", "calls": 2}, {"path": "/v1/search", "calls": 1}, {"path": "/v2/facts", "calls": 1}, {"path": "/v2/index_stats", "calls": 1}, {"path": "/v2/news", "calls": 1}]}

错误码

HTTPcode含义处理建议
401missing_token没有带 Authorization 头补上 Bearer <KEY>
401invalid_keyKey 无效或已吊销重新申请
429quota_exceeded当日额度用完次日重置,或提升套餐