curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
{
"entries_count": {
"total": 42,
"form_entries": 40,
"legacy_entries": 2,
"responses": {
"total": 38,
"elevation": { "percent": 15, "previous": 33, "type": "+", "period": { "start": "2026-08-01", "end": "2026-08-31" } }
},
"skips": { "total": 4, "elevation": null }
},
"responses": [["2026-09-01", 5], ["2026-09-02", 3]],
"skips": [["2026-09-01", 1]],
"responses_by_source": [["Direct", 10], ["docs-v2-first-qr-code", 28]]
}
العملاء المحتملون والنماذج
الحصول على تحليلات النموذج
GET /forms//analytics/
GET
/
forms
/
{form_id}
/
analytics
/
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
{
"entries_count": {
"total": 42,
"form_entries": 40,
"legacy_entries": 2,
"responses": {
"total": 38,
"elevation": { "percent": 15, "previous": 33, "type": "+", "period": { "start": "2026-08-01", "end": "2026-08-31" } }
},
"skips": { "total": 4, "elevation": null }
},
"responses": [["2026-09-01", 5], ["2026-09-02", 3]],
"skips": [["2026-09-01", 1]],
"responses_by_source": [["Direct", 10], ["docs-v2-first-qr-code", 28]]
}
يعيد تحليلات مجمَّعة لنموذج — أعداد الاستجابات/التخطي عبر الزمن وتفصيل حسب مصدر الزيارات.
تكون
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) وصلاحية LEAD_GENERATION_ANALYTICS_CAN_VIEW، يُرسَل كقيمة خام لترويسة Authorization — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة.string
مطلوب
معرّف
form_id للنموذج.string
تاريخ البدء (
YYYY-MM-DD). مطلوب مع to لحساب elevation (نسبة التغيّر مقابل فترة سابقة بنفس الطول).string
تاريخ الانتهاء (
YYYY-MM-DD).curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
{
"entries_count": {
"total": 42,
"form_entries": 40,
"legacy_entries": 2,
"responses": {
"total": 38,
"elevation": { "percent": 15, "previous": 33, "type": "+", "period": { "start": "2026-08-01", "end": "2026-08-31" } }
},
"skips": { "total": 4, "elevation": null }
},
"responses": [["2026-09-01", 5], ["2026-09-02", 3]],
"skips": [["2026-09-01", 1]],
"responses_by_source": [["Direct", 10], ["docs-v2-first-qr-code", 28]]
}
elevation بقيمة null في responses وskips تحت entries_count ما لم يُقدَّم كل من from وto. يحسب legacy_entries الإرساليات المُرحَّلة من قائمة عملاء محتملين تم تحويل هذا النموذج منها، إن وُجدت. يتضمن responses_by_source دائمًا مجموعة "Direct" (إرساليات بدون رمز QR مرفق) حتى عندما تكون 0.
ذو صلة
- سرد استجابات النموذج — الإرساليات الفردية وراء هذه الأرقام.
- تصدير استجابات النموذج — تنزيل البيانات الأساسية.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.
التفويضات
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 form.
هل كانت هذه الصفحة مفيدة؟