API REFERENCE
数据分析 API
以编程方式获取内容效果数据，构建自定义仪表盘或与 BI 系统集成
分析端点总览
数据分析 API 提供聚合指标查询能力，所有端点均支持时间范围过滤（start_date / end_date）和资源级别过滤（resource_id）。
| 端点 | 描述 |
|---|---|
GET /v1/analytics/overview | 账号级汇总数据：总浏览量、唯一访客数、线索数、平均停留时长 |
GET /v1/analytics/resources | 按内容资源分组的效果数据排行 |
GET /v1/analytics/resources/{id} | 单个内容资源的详细分析数据 |
GET /v1/analytics/channels | 按流量渠道（UTM Source）分组的数据 |
GET /v1/analytics/leads | 线索转化趋势数据，按日/周/月聚合 |
GET /v1/analytics/funnel | 内容-CTA-线索漏斗转化率分析 |
查询账号总览数据
# 查询最近30天的账号汇总数据
curl "https://api.cuiniao.com/v1/analytics/overview?start_date=2024-02-15&end_date=2024-03-15" \
-H "Authorization: Bearer ck_live_xxxxxxxxxxxx"
响应示例
{
"period": {
"start_date": "2024-02-15",
"end_date": "2024-03-15"
},
"summary": {
"total_page_views": 15842,
"unique_visitors": 8921,
"total_leads": 247,
"lead_conversion_rate": "2.77%",
"avg_dwell_seconds": 198,
"avg_scroll_depth": "62%"
},
"trend": {
"page_views_vs_prev": "+18.3%",
"leads_vs_prev": "+34.1%"
}
}
日期格式为
YYYY-MM-DD，时区默认为 UTC+8（中国标准时间）。可通过 timezone 参数指定其他时区。单内容资源详情
获取单个内容资源的完整分析数据，包括每日趋势、渠道分布和滚动深度分布。
curl "https://api.cuiniao.com/v1/analytics/resources/res_7fK2mPqLxNz?days=14&granularity=day" \
-H "Authorization: Bearer ck_live_xxxxxxxxxxxx"
响应示例（部分）
{
"resource_id": "res_7fK2mPqLxNz",
"title": "2024年B2B内容营销趋势报告",
"totals": {
"page_views": 2341,
"unique_visitors": 1876,
"leads": 43,
"avg_dwell_seconds": 267
},
"scroll_distribution": {
"0_25": "12%",
"25_50": "18%",
"50_75": "28%",
"75_100": "42%"
},
"top_channels": [
{"source": "linkedin", "visits": 980, "leads": 22},
{"source": "email", "visits": 610, "leads": 14},
{"source": "direct", "visits": 420, "leads": 5},
{"source": "wechat", "visits": 331, "leads": 2}
],
"daily_trend": [
{"date": "2024-03-01", "page_views": 182, "leads": 4},
{"date": "2024-03-02", "page_views": 156, "leads": 2}
]
}
漏斗分析
漏斗接口展示从内容浏览到线索转化的完整转化路径，帮助识别流失环节。
curl "https://api.cuiniao.com/v1/analytics/funnel?resource_id=res_7fK2mPqLxNz&days=30" \
-H "Authorization: Bearer ck_live_xxxxxxxxxxxx"
{
"funnel_steps": [
{"step": "page_view", "count": 2341, "rate": "100%"},
{"step": "scroll_50pct", "count": 1404, "rate": "60.0%"},
{"step": "cta_view", "count": 980, "rate": "41.9%"},
{"step": "cta_click", "count": 186, "rate": "7.9%"},
{"step": "form_submit", "count": 43, "rate": "1.8%"}
]
}