Loading...
Loading...
连接经过身份验证的外部 API，或使用 MCP 传输为代理和开发人员构建 YouTube 分析合约。
尝试实时端点。将 channel_id 和 YOUR_API_KEY 替换为您的值：
curl -X GET "https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Accept: application/json"JavaScript
const res = await fetch("https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<id>&range=28d", {
headers: { Authorization: "Bearer <api_key>" }
});
const data = await res.json();Python
import httpx
res = httpx.get(
f"{apiBase}/analytics",
params={"channel_id": "<id>", "range": "28d"},
headers={"Authorization": "Bearer <api_key>"}
)
data = res.json()从仪表板 → 设置 → API 密钥创建和撤销 API 密钥，或通过经过身份验证的 GET /api/v1/keys 和 POST /api/v1/keys 路由。
Professional+ plan使用 Authorization 标头中的 Bearer 令牌调用 https://www.tubeanalytics.net/api/external/v1 上的外部 API。
JSON responses将代理连接到 https://www.tubeanalytics.net/api/mcp 或在本地运行 npm run mcp:stdio 以进行 stdio 传输。
Agent ready使用 /openapi.json、/mcp.json 和 /ai.txt 作为集成和代理的机器可读事实来源。
Machine-readable登录、完成订阅流程并从仪表板连接频道。当前账户的认证管理路由为 GET /api/v1/channels/connect ，连接或刷新频道时为 POST /api/v1/channels/connect 。
转到仪表板 → 设置 → API 密钥并创建密钥，或使用经过身份验证的 POST /api/v1/keys 路由。 API 密钥可在专业版和企业版计划中使用。
对 https://www.tubeanalytics.net/api/external/v1 使用 Bearer 密钥。示例：GET /analytics?channel_id=<id>&range=28d 或 GET /videos?channel_id=<id>&limit=20。
对于 MCP 客户端，通过 HTTP 指向 https://www.tubeanalytics.net/api/mcp，或运行 npm run mcp:stdio 以进行本地 stdio 传输。
/api/external/v1/channels/api/external/v1/channels/:channelId/api/external/v1/analytics?channel_id=.../api/external/v1/videos?channel_id=.../api/external/v1/audience?channel_id=.../api/external/v1/competitors/api/v1/keys/api/mcp外部 API 请求必须使用不记名令牌方案在授权标头中包含有效的 API 密钥。将密钥保留在服务器端，切勿将其暴露在客户端代码中或将其提交给版本控制。
要生成或轮换 API 密钥，请转至仪表板 → 设置 → API 密钥。您还可以使用 GET /api/v1/keys、POST /api/v1/keys 和 DELETE /api/v1/keys/:keyId 管理经过身份验证的会话中的密钥。
Starter
1 channel · Creators validating one channel before spending more.
Professional
3 channels · Creators and small teams growing more than one channel.
Enterprise
5 channels · Agencies and multi-channel teams with reporting overhead.
curl -X GET https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d \
-H "Authorization: Bearer YOUR_API_KEY"外部 API 请求示例。 channel_id 可以是内部数据库 ID 或 YouTube 频道 ID。
专业版和企业版计划提供外部 API 访问。请求受到计划层的速率限制，当超过限制时，会返回 429 和速率限制标头。
速率限制响应标头
来自外部 API 的每个响应都包含这些标头，以便客户端可以主动管理回退：
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetRetry-After经过身份验证的外部请求使用 Bearer API 密钥流。仅会话管理路由（例如 /api/v1/keys 和 /api/v1/channels/connect）适用于登录的仪表板会话，不适用于服务器到服务器的 API 密钥调用。
外部 API 返回带有 error.code 和 error.message 的结构化 JSON 错误。登录的仪表板路由可能仍会返回简单的错误字符串，因此请检查路由或 OpenAPI 规范以了解确切的形状。
错误响应示例
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}400401403404429500大多数外部 API 端点接受用于过滤、分页和排序的通用查询参数。
channel_idrangelimitoffsetsort将渠道指标提取到您自己的工具中 - 将图表嵌入内部门户、客户报告或 Metabase 或 Grafana 等 BI 平台。
通过从后端或自动化工作人员调用外部 API，安排夜间同步到 Google Sheets、Notion 或仓库。
使用 MCP 传输或本地 stdio 传输使代理能够访问相同的产品合同、分析和帐户数据。
将 API 数据与广告、CRM 或财务系统相结合，使渠道绩效与堆栈的其他部分保持一致。
使用这些页面从端点发现转向生产集成和工作流程部署。
专业版和企业版计划提供 API 访问权限。注册、连接通道，然后创建 API 密钥并开始调用外部 API 或 MCP 传输。