第5章：You.com Finance Research API

APIsFinance Research APIFinance Research API 概览|以 Markdown 查看|在 Claude 中打开|通过 MCP 将 You.com 接入你的 agent 或 IDE——访问 https://api.you.com/mcp 建立连接。无需注册即可试用 search：https://api.you.com/mcp?profile=free（you-search 和 you-discover）。Research 和 finance 请使用 /mcp/research 和 /mcp/finance，或在 /mcp 上使用 ?tools=。MCP Server 指南 → 安装 Docs MCP server

Docs MCP server 让你的 agent 能够搜索全部文档。免费使用。安装 https://you.com/docs/_mcp/server。详情请参阅 Docs MCP Server 指南。

什么是 Finance Research API？

Finance Research API 针对金融问题提供有据可依、带引用来源的答案。

它的工作方式与 Research API 相同：执行多次搜索、阅读各类来源，并将所有内容综合成一份详尽的 Markdown 格式答案，附带内联引用。关键区别在于索引。Finance Research API 不搜索开放网络，而是搜索一个专门构建的金融索引——涵盖结构化公司基本面数据、股票和大宗商品价格、私营公司指标、另类信号、宏观经济指标、SEC 文件以及财经新闻。

提出一个金融问题，得到一个由合适数据支撑、注明来源的答案。

端点

每个 API 都有自己的端点。每次请求都需要在 X-API-Key 请求头中携带你的 API key。

| API | 端点 | 指南 | API 参考 | |---|---|---|---| | Web Search API | POST https://ydc-index.io/v1/search（也支持 GET）| 概览 | /v1/search | | Contents API | POST https://ydc-index.io/v1/contents | 概览 | /v1/contents | | Answer API | POST https://api.you.com/v1/answer | 概览 | /v1/answer | | Research API | POST https://api.you.com/v1/research | 概览 | /v1/research | | Finance Research API | POST https://api.you.com/v1/finance_research | 概览 | /v1/finance_research |

Answer、Research 和 Finance Research API 只在 api.you.com 上运行。将这些路径发送到 ydc-index.io 会返回 403 和 {"message": "Missing Authentication Token"}，即使 key 是有效的。

与 Research API 的区别

两个 API 遵循相同的请求-响应模式，返回相同的响应结构。区别在于各自搜索的内容。

| | Research API | Finance Research API | |---|---|---| | 索引 | 开放网络 | 金融优化索引：结构化基本面数据、股票和大宗商品价格、私营公司数据、另类信号、宏观指标、SEC 文件、财经新闻 | | 输入 | 任意研究问题 | 金融问题——公司分析、市场研究、财报、宏观经济 | | 参数 | input, research_effort, source_control, output_schema | input, research_effort, output_schema | | 响应 | 带引用的 Markdown 答案，或使用 output_schema 的 JSON 对象 | 带引用的 Markdown 答案，或使用 output_schema 的 JSON 对象（结构相同）| | 最适合 | 通用研究 | 金融分析、尽职调查、财报摘要、市场研究 |

Finance Research API 不支持 source_control。如果需要域名过滤，请使用 Research API。两个 API 都接受相同的 output_schema 用于结构化 JSON 输出。

返回内容

每个 Finance Research API 响应都包含：

- content：Markdown 格式的答案，附带如 [[1, 2]] 的内联引用，指向 sources 数组中的条目。发送 output_schema 时，content 变为符合你 schema 的 JSON 对象。 - content_type：默认为 text，发送 output_schema 时为 object。 - sources：API 阅读并引用的金融来源——每个都包含 URL、标题和相关摘录。

``` { "output": { "content": "For fiscal year 2025, ended January 26, 2025, NVIDIA's revenue rose to $130.5 billion, up 114% year over year.[[1]] The main drivers were:\n\n- Data Center demand, especially accelerated computing and AI platforms: Data Center revenue was up 142%, driven by demand for NVIDIA's Hopper architecture for large language models, recommendation engines, and generative AI applications; NVIDIA also began shipping Blackwell production systems in Q4 FY2025.[[1]]\n- Compute & Networking segment growth: revenue increased 145%, with Data Center compute up 162% on Hopper demand and Data Center networking up 51%, driven by Ethernet for AI, including Spectrum-X.[[1]]\n- Smaller but positive contributions from other markets: Gaming revenue rose 9% on GeForce RTX 40 Series GPUs, Professional Visualization rose 21% on Ada RTX workstation adoption, and Automotive rose 55% from self-driving platform sales.[[1]]\n\nIn short, NVIDIA's FY2025 growth was overwhelmingly driven by AI-related Data Center compute and networking demand, with additional support from gaming, professional visualization, and automotive.", "content_type": "text", "sources": [ { "url": "https://investor.nvidia.com/financial-info/financial-reports/default.aspx", "title": "NVIDIA Corporation - Financial Reports" } ] } } ```

核心特性

研究力度等级

research_effort 参数控制 API 为你的问题分配多少计算资源。力度越高，搜索越多、来源阅读越深、交叉引用越频繁——代价是响应时间更长。

| 等级 | 每 1k 价格 | 延迟 | 适用场景 | |---|---|---|---| | deep | $110 | < 120s | 多来源分析——财报摘要、竞争对标、监管研究、多季度趋势（默认）| | exhaustive | $500 | < 300s | 全面研究——深度尽职调查、完整 10-K 分析、跨市场研究 |

Finance Research API 没有后台模式，所以每个请求都会保持连接，直到答案就绪。请将 HTTP 客户端超时设置为：deep 大于 120s，exhaustive 大于 300s。

带引用的答案

响应中的每个论断都链接到具体来源。引用涵盖 SEC 文件、财报新闻稿、财经新闻和分析师报告——你的用户或合规团队可以实际核实的来源。

金融优化索引

Finance Research API 搜索专门的金融索引，而不仅仅是开放网络。这意味着检索聚焦于结构化金融数据——而不是恰好提到某个股票代码的大众内容。索引涵盖：

- 公司基本面——盈利、预估、估值比率、行业标准化财务数据、竞争对手基准、分部指标 - 市场活动——上市和私营公司的并购交易、回购、融资、IPO、储架注册、VC 融资 - 价格和利率——覆盖 42 个全球交易所的股票价格和成交量、加密货币、外汇、金属、大宗商品、利率、通胀和房地产 - 另类信号——网络流量和应用分析、非 GAAP 运营指标、LLM 基准测试 - 宏观经济数据——就业指标、能源进出口、货币供应量和经济指标 - 金融内容——SEC 文件、财报电话会议记录、分析师覆盖和财经新闻

参数

| 参数 | 类型 | 必填 | 描述 | |---|---|---|---| | input | string | 是 | 金融研究问题（最多 40,000 字符）| | research_effort | string | 否 | 研究深度：deep（默认）、exhaustive | | output_schema | object | 否 | 用于结构化 JSON 响应的 JSON Schema，输出在 output.content。参见结构化输出 |

查看完整 API 参考

常见使用场景

财报分析

快速总结公司最近一个季度的表现——营收、分部业绩、业绩指引和分析师反应——无需手动阅读新闻稿和财报电话会议记录。

"总结 Microsoft FY2025 Q2 财报结果和关键业绩指引更新"

竞争对标

比较多家公司在财务指标和商业模式特征上的差异，评估它们在市场中的相对定位。

"比较 Apple、Microsoft 和 Google 过去三个财年的毛利率"

``` { "output": { "content": "Gross margin comparison (gross margin % = gross profit / revenue) for the last three fiscal years:\n\n| Company | FY2025 | FY2024 | FY2023 | Takeaway |\n|---|---:|---:|---:|---|\n| Microsoft | 68.8% — $193.893B gross margin / $281.724B revenue [[2]] | 69.8% — $171.008B / $245.122B [[2]] | 68.9% — $146.052B / $211.915B [[2]] | Highest margins, broadly stable. |\n| Google / Alphabet | 59.7% — ($402.836B revenue − $162.535B cost of revenues) / $402.836B [[3]] | 58.2% — ($350.018B − $146.306B) / $350.018B [[3]] | 56.6% — ($307.394B − $133.332B) / $307.394B [[3]] | Middle, improving each year. |\n| Apple | 46.9% [[1]] | 46.2% [[1]] | 44.1% [[1]] | Lowest of the three, but steadily improving. |\n\nBottom line: Microsoft had the strongest gross margins in all three fiscal years, Google/Alphabet was second and improving, and Apple was lowest but also improved from FY2023 to FY2025.", "content_type": "text", "sources": [ { "url": "https://fintel.io/doc/sec-apple-inc-320193-10k-2025-october-31-20392-514", "title": "Apple Inc. - 10K - Annual Report - October 31, 2025" }, { "url": "https://s2.q4cdn.com/470004039/files/doc_financials/2025/ar/_10-K-2025-As-Filed.pdf", "title": "UNITED STATES SECURITIES AND EXCHANGE COMMISSION Washington, D.C. ..." }, { "url": "https://www.studocu.com/en-us/document/miami-university/intro-to-financial-accounting/apple-inc-2025-consolidated-financial-statements-analysis/149162812", "title": "Apple Inc. 2025 Consolidated Financial Statements Analysis - Studocu" } ] } } ```

尽职调查研究

收集关于公司财务状况、资本结构或风险因素的有据可查、可验证的信息——引用可追溯到原始来源。

"Palantir 最新 10-K 文件中披露的关键风险因素有哪些？"

宏观经济研究

研究宏观趋势、央行政策、通胀动态，及其对特定行业或资产类别的影响。

"自 2022 年以来，美联储的利率路径如何影响了商业地产估值？"

监管与文件分析

深入挖掘 SEC 文件、监管披露或财务重述，了解公司报告了什么、随时间发生了哪些变化。

"Boeing 在最近年报中对收入确认政策做了哪些修改？"

最佳实践

让研究力度匹配问题

deep 能很好地处理大多数金融问题——财报摘要、行业对比、多公司基准比较。当你需要最高质量的 结果 且响应时间不是约束时，使用 exhaustive，比如完整的 10-K 分析或复杂的跨市场研究。

提问要具体、范围明确

input 字段支持最多 40,000 字符。提供能缩小问题范围的上下文：公司名称、时间段、你关心的具体指标或事件。像"介绍一下 Microsoft"这样模糊的问题只会产生泛泛的总结。像"是什么推动了 Microsoft Azure 在 FY2025 Q2 的增长加速"这样的具体问题，会产生更有用的答案。

合规敏感场景请核实引用

Finance Research API 为每个论断都返回引用。当这些数据将用于投资决策、客户报告或监管文件时，请把引用当作起点——追溯到原始来源并确认数字后再采取行动。这个 API 是研究加速器，不能替代对原始来源的核实。

用于综合分析，而非程序化数据管道

Finance Research API 产出的是研究型答案——它阅读、交叉引用并综合数据，形成带来源的响应。它不是结构化数据源或时间序列 API。如果需要原始 OHLCV 导出、逐笔价格流或用于量化建模的完整时间序列，请使用专业的数据服务商。如果想让研究结果以类型化字段而非文字形式返回，可以添加 output_schema。Finance Research API 最适合那些价值在于分析而非原始数字的问题。

定价

Finance Research API 按力度等级定价。完整的定价和各等级延迟信息请参阅 Billing 页面。

各等级的具体表现请参考上文力度等级表。

如需批量折扣、年度定价或企业功能，请访问 you.com/pricing 或联系 api@you.com。

Agent 也可以无需账户按次付费。POST /v1/finance_research 接受机器支付，价格与各等级定价相同，每次请求从充值钱包中以 USDC 结算，而不是扣除积分。

后续步骤

- 快速开始：发起你的第一个 Finance Research API 请求 - API 参考：完整参数参考、请求/响应 schema 和交互式 playground - Research API：支持来源控制、结构化输出和开放网络访问的通用研究 - 在 Postman 中试用：Fork collection，添加你的 API key，发送第一个请求