curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
潜在客户与表单
导出潜在客户条目
GET /lead//entry/export/
GET
/
lead
/
{lead_id}
/
entry
/
export
/
curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
将潜在客户列表的条目下载为 CSV 或 Excel 文件。
响应是文件下载(
如果
需要具有
MANAGEMENT_API(或 MANAGEMENT_API_SANDBOX)配额和 LEAD_GENERATION_ENTRY_CAN_VIEW 权限的管理 API 密钥,作为原始 Authorization 标头值发送 —— 参见管理 API 概述。string
必填
潜在客户列表的
lead_id。string
默认值:"csv"
csv、xls 或 xlsx。string
仅包含在此日期(含)之后创建的条目(
YYYY-MM-DD)。string
仅包含在此日期(含)之前创建的条目(
YYYY-MM-DD)。string
以逗号分隔的条目 UUID,用于将导出范围限定为特定选择 —— 对应仪表板的”下载所选项”操作。无效的 UUID 会被静默忽略而非报错。
curl --request GET \
--url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--output entries.csv
Content-Type: text/csv,或 xls/xlsx 对应的 XLSX MIME 类型),而非 JSON,带有 Content-Disposition: attachment; filename=<LeadListName>-<timestamp>.<ext>。
无论账户其他位置的追踪权限如何,导出文件始终包含
tracking_id 列。如果提交所用的 QR 码此后已被删除,其列值会渲染为 <qrid> (Deleted),而不会导致导出失败。当没有匹配的条目时,文件仍会包含一个表头行(源自潜在客户表单自身的问题标签),而不是为空。在免费计划账户(
plan_type 1)上,导出限制为 25 行 —— 如果匹配的条目超过此数,会在末尾附加两行说明达到限制并建议升级。file_format 不是 csv、xls 或 xlsx 之一,则返回带纯文本正文(而非标准 DRF 错误格式)的 400:
400
{ "detail": "requested file format unknown" }
相关内容
授权
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
CSV or XLSX file download.
此页面对您有帮助吗?