curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
潜在客户与表单
获取潜在客户分析
POST /lead/analytics/
POST
/
lead
/
analytics
/
curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
返回一个或多个潜在客户列表的聚合分析（条目计数、转化细分和流量来源）。
当所请求周期及其之前的对比周期均为零条目时，
需要具有
MANAGEMENT_API（或 MANAGEMENT_API_SANDBOX）配额和 LEAD_GENERATION_ANALYTICS_CAN_VIEW 权限的管理 API 密钥，作为原始 Authorization 标头值发送 —— 参见管理 API 概述。array
必填
标识要分析的潜在客户列表的字符串数组 —— 根据
filter_by 的值，为 lead_id 或 QR 的 url_hash。string
默认值:"lead_id"
lead_id（默认）或 qr_hash。string
默认值:"entries_count"
要计算的以逗号分隔的子集，取自
entries_count、leads_conversion、source。string
起始日期（
YYYY-MM-DD）。默认为 to 之前 7 天。string
结束日期（
YYYY-MM-DD）。默认为今天。curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
elevation 为 null，以避免出现误导性的百分比。如果 q 缺失或为空，则在 q 下返回 400 —— 此端点的契约是 {"q": [...], "filter_by": "..."}，而不是较旧的、不兼容的 {"lead_list": [...], "date_from": "...", "date_to": "..."} 形式。
相关内容
授权
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
响应
200
Aggregated analytics for the requested lead lists.
此页面对您有帮助吗？