用途:通过标准 HTTP 客户端直接调用 You.com 的 Research、Search、Contents 三个 REST API,无需任何 SDK。Search API 无 API 密钥时每天可免费搜索 100 次;Research 与 Contents 始终需要密钥,通过 X-API-Key 请求头认证,密钥可在 https://you.com/platform 获取。
主要能力:Research API(POST https://api.you.com/v1/research)接收 input(最长 40000 字符)和可选 research_effort(lite/standard/deep/exhaustive),自主执行多次搜索、阅读与交叉比对,返回带内联引用编号的 Markdown 答案及 sources 数组;耗时从 2 秒内到 300 秒内不等。Search API(GET https://api.you.com/v1/agents/search)返回原始 web 与 news 结果,支持 count、freshness、offset、country、language、safesearch、livecrawl、livecrawl_formats、include_domains、exclude_domains、crawl_timeout 等查询参数。Contents API(POST https://ydc-index.io/v1/contents)按 urls 数组抓取页面,可返回 html、markdown、metadata,crawl_timeout 默认 10 秒。
使用方式:选择路径 A(Research 一步获得带引用答案)或路径 B(Search + Contents 自行处理原始数据)。可用各语言内置 HTTP 客户端;Python 可选 pip install requests 或 pip install httpx。设置环境变量 export YDC_API_KEY="your-key-here" 后调用对应端点。各端点的输入输出 JSON Schema 已在资料中列出。
适用场景:Research 用于客服问答、竞品情报、尽职调查、合规监测、内容生成、内部知识助手、文献综述、财务分析;Search + Contents 用于自建 RAG、搜索 UI、新闻监控、电商检索、文档爬取、编码辅助、链接预览、价格抓取。
限制:Search 免费额度用尽后及 Research、Contents 均需密钥;Research 高 effort 延迟最长约 300 秒且成本更高;错误返回标准 HTTP 状态码(如 401)。其他价格、配额与平台细节资料未提供。