SIJI RESEARCH API

把产业网接入你的研究。

一个 API Key，九个研究原语。从产业全貌开始，也可以直接进入已知公司或产品。

调用第一个接口

先创建 API Key，并保存在工具的 Secret 或连接器配置中。管理 API Key →

# 把 Key 放在本机环境变量中。
export SIJI_API_KEY='YOUR_API_KEY'

curl --fail-with-body '<SIJI_ORIGIN>/v1/agent/world/overview' \
  -H "X-API-Key: $SIJI_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: my-first-world-overview-001' \
  --data '{}'

示例使用当前站点地址。同一请求重试时复用 Idempotency-Key；新的研究请求使用新值。

宽泛产业问题: overview → changes / graph → facts → evidence
已知公司或产品: search_entities → get_entities → graph / facts / evidence

机器可读能力目录 ↗

先看产业全貌

POST /v1/agent/world/overview 返回当前产业网中的类别、产业位置、公司、产品与轻量关系。请求体可以从空对象开始。

选中感兴趣的对象，保留返回的类型与引用，再用实体、图谱、事实和证据接口继续研究。

查看 Context Memory 研究案例 →

九个研究原语

操作	POST /v1/agent/	用途
`get_world_overview`	`world/overview`	浏览公司、产品、产业位置与关系全貌
`search_entities`	`entities/search`	按名称、别名、代码或主题找到实体
`get_entities`	`entities/get`	重新打开已经返回的实体引用
`list_changes`	`changes/list`	查看近期变化或跟踪指定对象
`expand_graph`	`graph/expand`	从已知对象继续展开关系
`trace_paths`	`graph/paths`	寻找对象之间或通向指定类型的路径
`get_facts`	`facts/get`	读取事实、状态、时间、范围与引用
`get_evidence`	`evidence/get`	获取事实和关系背后的证据与来源
`compare`	`compare`	按共同维度比较明确的研究对象

查看完整请求与返回 Schema ↗

让返回对象成为下一步

实体与关系：保留返回的类型、引用与关系语义，后续查询直接复用。
事实与证据：结合状态、时间、适用范围与来源理解每条事实。
Coverage: 保留 partial、unknown、conflict 等状态，用于决定还需要补充哪些研究。
Pagination: 继续查询时复用返回的 cursor，保持原请求条件。

认证、重试与额度

请求通过 X-API-Key 认证。请把密钥保存在工具的 Secret 或服务端环境变量中。

同一账户下的 Key 共用套餐与 RU。请求结果包含本次用量；重试相同请求时复用 Idempotency-Key，新请求使用新值。遇到请求限制时，遵循响应中的 Retry-After。

Free 每个 UTC 自然月包含 300 RU。中国市场 Starter、Pro、Research Pro 每服务月分别包含 1,500、6,000、20,000 RU；国际市场分别为 2,000、6,250、18,000 RU。实际额度以套餐页当前计费市场为准。

各套餐的请求速率、并发、Key 数量与单次查询限制可在账户及套餐页查看。

比较套餐与价格 →

一次获取研究资料包

POST /v1/research 支持 company、product、industry、compare、changes 五类任务，提供 JSON 或 Markdown 形式的结构化研究资料。

使用同一个 X-API-Key，根据任务选择 mode 与 query。

与公开 Web 一起使用

SIJI 提供稳定的产业结构、对象身份、关系、商业事实与来源锚点。研究近期变化或读取最新原文时，可以继续补充公开 Web 检索。