查询取数接入路线
推荐阅读顺序，不代表完成进度；可选步骤可以跳过。
查看完整路线
使用指南
通过 API 查询已授权的数据，读取完整正文、图片、附件和结构化字段。
第一次使用
先获取与使用 API Key，再完成第一次查询。接着按需求搜索或筛选内容，取得 document.id 后读取正文、历史和附件，最后设置限流与重试。每一步的页底都有完成标准和推荐下一步。
已有 Key 可以直接进入首次查询，无需先登录 Portal。如果你负责管理应用，可在应用与订阅管理中管理密钥和授权。搜索摘要不是完整正文；没有附件需求可以跳过附件步骤。服务地址：https://www.marsyoo.com。
选择你要做的事情
| 目标 | 阅读入口 |
|---|---|
| 按关键词、平台或时间查询 | 关键词检索 |
| 语义相似或混合检索 | 选择检索模式 |
| 读取用户资料和该用户发布的内容 | 读取用户资料与用户内容 |
| 按话题、标签或分类精确筛选内容 | 按条件筛选内容 |
| 获取可用分类 code | 查询分类字典 |
| 读取完整正文 | 读取完整正文 |
| 查看内容编辑历史 | 查看正文版本历史 |
| 查看点赞、播放量或作者指标历史 | 查看指标与作者快照 |
| 获取字幕、OCR 和结构化字段 | 读取内容与历史 |
| 获取图片和文件 | 下载图片与附件 |
| 一次性批量取走大量内容 | 批量导出数据 |
| 持续同步新增和变化数据 | 增量同步数据 |
| 临时发起新采集并读取结果 | 按需采集新数据 |
| 定期采集用户、频道或话题 | 定期采集用户与频道 |
| 使用 Python 或 Go 开发应用 | 查询 SDK（Python 与 Go） |
| 在 AI 应用中调用查询工具 | MCP 接入 |
不确定平台或字段是否可用时，查看平台覆盖和应用订阅。 查询为空时先检查查询条件、时间窗口与授权范围；请求失败时查看限流、重试与排错。
试验功能
分析任务（Preview）目前仅提供任务与订阅管理，尚不能产出分析结果。不属于首次接入路线，不要依赖它完成数据获取。
接口与文档下载
字段与枚举见公开 API Reference或 /public-openapi.yaml。
页面顶部可下载 Markdown；文档索引为 /llms.txt，完整文本为 /llms-full.txt，均无需登录。
开发采集器、上传采集数据请进入采集器开发文档，需接入授权。