面向 AI Agent 的产业事实检索接口。全部为 GET 请求,返回 JSON。鉴权用 Authorization: Bearer <KEY>,免费 Key 在 申请页 领取。
| 项目 | 值 |
|---|---|
| Base URL | https://cloud.ygwws.xyz |
| 鉴权 | Authorization: Bearer <KEY> |
| 返回格式 | JSON(UTF-8) |
| 限流 | 按 Key 每日限额,超限返回 429 |
| OpenAPI | openapi.json(可直接导入 Postman / 代码生成器) |
/v1/search — 检索(含无答案检测)检索(含无答案检测)。返回:命中返回 results 数组,每条带 url/title/snippet;无合适结果返回 found=false
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 否 | 查询词,支持中英文 |
limit | integer | 否 | 返回条数,默认 10,最大 50 |
allow_external | integer | 否 | 是否允许库外兜底(默认 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"}}
/v1/research — 多步检索并汇总(研究模式)多步检索并汇总(研究模式)。返回:返回多段证据 + 汇总,每段带出处
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 否 | 研究主题 |
depth | integer | 否 | 检索深度 1-3 |
/v1/extract — 从指定 URL 抽取结构化内容从指定 URL 抽取结构化内容。返回:返回正文、标题、发布时间;抽取失败返回 error
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 否 | 要抽取的页面 URL |
/v2/index_search — 库内全文检索(FTS5)库内全文检索(FTS5)。返回:返回库内匹配的文档与片段
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 否 | 查询词 |
limit | integer | 否 | 返回条数 |
/v1/schema/fields — 字段字典字段字典。返回:所有字段的名称、类型、单位、含义。单位换算(crore/billion)在这里说明,Agent 必读
/v2/facts — 结构化事实(带原文证据句)结构化事实(带原文证据句)。返回:每条含 company/amount/currency/unit/capacity/location + evidence_* 原文句
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
min_amount | number | 否 | 最小金额(原币数值) |
conflicts | integer | 否 | 只看数值有冲突的记录,1/0 |
limit | integer | 否 | 返回条数 |
真实返回摘录(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 …(截断)
/v2/structured — 结构化抽取(指定 URL 或文本)结构化抽取(指定 URL 或文本)。返回:返回字段化的抽取结果 + 证据
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 否 | 页面 URL |
text | string | 否 | 或直接给正文文本 |
/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 …(截断)
/v2/brief — 当日简报当日简报。返回:返回多源事件 + 结构化事实,可直接喂给模型
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
date | string | 否 | 日期,默认今天 |
/v2/news — 按日期/国家/来源查资讯按日期/国家/来源查资讯。返回:返回 news 记录数组(标题、摘要、来源、发布时间、url)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
country | string | 否 | 两位国家码 |
source | string | 否 | 来源域名,支持子串 |
date | string | 否 | 发布日期 YYYY-MM-DD |
limit | integer | 否 | 返回条数 |
真实返回摘录(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 …(截断)
/v2/news/stats — 资讯量统计资讯量统计。返回:按天/国家的条目数
/v2/fulltext — 取正文全文取正文全文。返回:返回我们抓取时保存的正文;原文付费墙或无正文时该条不返回
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
url | string | 否 | 原文 URL(精确匹配) |
limit | integer | 否 | 返回条数 |
/v2/fulltext/stats — 全文覆盖率全文覆盖率。返回:全文池总量、有正文的比例、按来源分布
/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}, {" …(截断)
/v2/query_stats — 查询量统计查询量统计。返回:近 N 日查询次数与热门词
/v1/signup — 自助领取 API Key自助领取 API Key。返回:返回 key 与每日限额;同一邮箱重复领取返回已有 key
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
email | string | 否 | 邮箱(用于找回与用量通知) |
/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}]}
| HTTP | code | 含义 | 处理建议 |
|---|---|---|---|
| 401 | missing_token | 没有带 Authorization 头 | 补上 Bearer <KEY> |
| 401 | invalid_key | Key 无效或已吊销 | 重新申请 |
| 429 | quota_exceeded | 当日额度用完 | 次日重置,或提升套餐 |