REALTRACEAPI 能力全景

API v1 · SYSTEM-NATIVE ACCESS

从明确接口到可审计结果，一张图看懂 RealTrace API

API 与 MCP 是 RealTrace 提供的两种接入方式。73 条接口采用 RealTrace 自有命名与稳定契约，统一覆盖鉴权、权限、数据查询、分页、响应、计费与调用日志。

查看 73 条接口契约 ↗先看接入模型
01 / REQUEST ARCHITECTURE

一次请求，在 RealTrace 内完整闭环

业务系统只需要集成 RealTrace API。令牌校验、平台权限、数据查询、结果交付、Credits 计费与调用审计都由 RealTrace 统一完成。

CLIENT你的业务系统后端服务、数据管道、内部应用Authorization: Bearer …
CONTRACTRealTrace API v1稳定路径、明确参数、一接口一项业务动作GET /api/v1/…
ACCESS访问与权益令牌权限、会员权益、余额与额度access · entitlement · credits
QUERY数据查询按接口契约执行查询、分页与结果校验query · pagination · validation
RESULT结果与审计标准 JSON 交付，附带计费和追踪信息data · meta · request_id
02 / NAMING STANDARD

统一命名，让接口直接表达业务

路径只描述 RealTrace 支持的业务域、平台、资源与动作，结构可读、可预测；每条接口单独明确参数、约束与分页方式。

/api/v1/{domain}/{platform}/{resource}/{action}
domaincommerce / social
platformamazon / tiktok / linkedin…
resourceproducts / posts / comments…
actionsearch / get / list
GET /api/v1/commerce/amazon/products/searchGET /api/v1/social/linkedin/comments/list
03 / CONTRACT STANDARD

接入时只需要记住六条规则

所有接口都遵循同一套接入标准；平台特有的输入差异在每条接口契约中单独列明，不用猜参数，也不隐藏固定值。

01 / ROUTE

一接口一项业务动作

每条路径只完成一个平台的一项明确业务动作，便于开发、授权、统计与排错。

02 / AUTH

Bearer 令牌鉴权

令牌可配置为仅 MCP、仅 API 或融合权限；所有请求使用 Authorization Header。

03 / PARAMS

参数契约清晰可验

每条接口明确列出必填项、枚举、格式、默认值、固定参数和分页规则。

04 / RESPONSE

统一 JSON 信封

成功响应交付 data 与 meta；全局 request_id 用于日志定位与审计。

05 / ERROR

标准状态码与错误体

鉴权、参数、权限、余额和查询执行错误采用一致结构，不把失败伪装成成功空数据。

06 / BILLING

与 MCP 同价

只有成功交付目标数据的有效查询才计费；空结果、参数拦截和执行失败不扣 Credits。

04 / DATA COVERAGE

73 条接口覆盖 17 个数据渠道

X 与 LinkedIn 已纳入社媒体系；TikTok Shop 七个区域分别作为明确的平台契约，不用在同一接口里混用区域参数。

COMMERCE38

商品、详情、评论、店铺与榜单

AmazonWalmartTargetTikTok Shop USSGVNIDTHMYPH
SOCIAL35

内容、账号、评论、回复与字幕

TikTokYouTubeRedditFacebookInstagramXLinkedIn
05 / MCP ↔ API PARITY

入口不同，业务能力相同

MCP 用更少的语义工具让 Agent 自主选择平台；API 把同一能力展开为平台级明确接口，方便程序稳定集成。

业务能力MCP 工具API 接口
Amazon 商品搜索search_productsGET /api/v1/commerce/amazon/products/search
TikTok 内容搜索search_postsGET /api/v1/social/tiktok/posts/search
YouTube 字幕get_captionsGET /api/v1/social/youtube/captions/get
X 内容搜索search_postsGET /api/v1/social/twitter/posts/search
LinkedIn 评论get_social_commentsGET /api/v1/social/linkedin/comments/list
06 / HOW TO CHOOSE

按调用者选择，不按数据能力选择

两种接入方式可以同时存在于同一个团队、同一个账户和同一组业务流程中。

MCP / AGENT NATIVE

调用者是 AI Agent

目标由自然语言描述，Agent 需要自行判断工具、平台与调用顺序。

  • Codex、WorkBuddy、ChatGPT、Claude 等客户端
  • 跨平台研究、探索与多步编排
  • 20 个语义工具与结构化恢复
API / SYSTEM NATIVE

调用者是业务系统

路径、参数与执行顺序由代码明确控制，需要稳定契约与标准 HTTP 响应。

  • 后端服务、数据管道与内部应用
  • 定时任务、批处理与产品功能集成
  • 73 条平台级明确接口

准备好之后，从完整接口契约开始

登录控制台可查看 73 条接口的路径、参数、必填项、固定值、分页说明与响应标准；令牌、余额、费率和调用日志与 MCP 共用。

进入 API 接入指南 ↗查看 MCP 能力全景