## 查询取数接入路线

以下是推荐阅读顺序，不代表已完成的进度；可选步骤可以跳过。

1. [获取与使用 API Key](/docs/authentication)
2. [完成第一次查询](/docs/quickstart)
3. [关键词与语义检索](/docs/search)
4. [用户、话题、标签与分类](/docs/browse)（可选）
5. [读取内容与历史](/docs/documents)
6. [下载图片与附件](/docs/attachments)（可选）
7. [限流、重试与排错](/docs/production)

# 使用指南

通过 API 查询已授权的数据，读取完整正文、图片、附件和结构化字段。

## 第一次使用

先[获取与使用 API Key](/docs/authentication)，再[完成第一次查询](/docs/quickstart)。接着按需求搜索或筛选内容，取得 `document.id` 后读取正文、历史和附件，最后设置限流与重试。每一步的页底都有完成标准和推荐下一步。

已有 Key 可以直接进入[首次查询](/docs/quickstart)，无需先登录 Portal。如果你负责管理应用，可在[应用与订阅管理](/docs/portal)中管理密钥和授权。搜索摘要不是完整正文；没有附件需求可以跳过附件步骤。服务地址：`https://www.marsyoo.com`。

## 选择你要做的事情

| 目标 | 阅读入口 |
| --- | --- |
| 按关键词、平台或时间查询 | [关键词检索](/docs/search) |
| 语义相似或混合检索 | [选择检索模式](/docs/search#检索模式怎么选) |
| 读取用户资料和该用户发布的内容 | [读取用户资料与用户内容](/docs/browse#读取用户资料与用户内容) |
| 按话题、标签或分类精确筛选内容 | [按条件筛选内容](/docs/browse#按条件筛选内容) |
| 获取可用分类 code | [查询分类字典](/docs/browse#查询分类字典) |
| 读取完整正文 | [读取完整正文](/docs/documents#读取完整正文) |
| 查看内容编辑历史 | [查看正文版本历史](/docs/documents#查看正文版本历史) |
| 查看点赞、播放量或作者指标历史 | [查看指标与作者快照](/docs/documents#查看指标与作者快照) |
| 获取字幕、OCR 和结构化字段 | [读取内容与历史](/docs/documents) |
| 获取图片和文件 | [下载图片与附件](/docs/attachments) |
| 一次性批量取走大量内容 | [批量导出数据](/docs/exports) |
| 持续同步新增和变化数据 | [增量同步数据](/docs/change-feed) |
| 临时发起新采集并读取结果 | [按需采集新数据](/docs/live-query) |
| 定期采集用户、频道或话题 | [定期采集用户与频道](/docs/collection-subscriptions) |
| 使用 Python 或 Go 开发应用 | [查询 SDK（Python 与 Go）](/docs/sdk) |
| 在 AI 应用中调用查询工具 | [MCP 接入](/docs/mcp) |

不确定平台或字段是否可用时，查看[平台覆盖](/docs/platforms)和应用订阅。
查询为空时先检查查询条件、时间窗口与授权范围；请求失败时查看[限流、重试与排错](/docs/production)。

## 试验功能

[分析任务（Preview）](/docs/analysis)目前仅提供任务与订阅管理，尚不能产出分析结果。不属于首次接入路线，不要依赖它完成数据获取。

## 接口与文档下载

字段与枚举见[公开 API Reference](/public-api-reference)或 `/public-openapi.yaml`。
页面顶部可下载 Markdown；文档索引为 `/llms.txt`，完整文本为 `/llms-full.txt`，均无需登录。

开发采集器、上传采集数据请进入[采集器开发文档](/internal)，需接入授权。

## 检查与继续

**推荐下一步**：[获取与使用 API Key](/docs/authentication)