NueForm

Analytics API

अपने फॉर्म्स के लिए रिस्पॉन्स मेट्रिक्स और completion analytics प्राप्त करें।

Analytics API फॉर्म रिस्पॉन्स के बारे में aggregated मेट्रिक्स प्रदान करता है, जिसमें कुल गणना, completion दरें, और दैनिक breakdown शामिल हैं।

सभी response bodies snake_case फ़ील्ड नामों का उपयोग करते हैं।

फॉर्म Analytics डैशबोर्ड
Analytics डैशबोर्ड जो रिस्पॉन्स मेट्रिक्स और completion दरें दिखाता है।
Endpoints
GET/api/v1/forms/:id/analytics

फॉर्म Analytics प्राप्त करें

GET/api/v1/forms/:id/analytics

किसी विशिष्ट फॉर्म के लिए रिस्पॉन्स analytics लौटाता है। आप वैकल्पिक रूप से किसी विशेष समय अवधि का विश्लेषण करने के लिए तिथि सीमा फ़िल्टर कर सकते हैं।

Path Parameters

idstring

फॉर्म ID

Query Parameters

sincestring

ISO 8601 तिथि। केवल इस तिथि पर या उसके बाद सबमिट किए गए रिस्पॉन्स शामिल करें।

untilstring

ISO 8601 तिथि। केवल इस तिथि पर या उससे पहले सबमिट किए गए रिस्पॉन्स शामिल करें।

Response Fields

form_idstring

फॉर्म ID

total_responsesinteger

कुल submissions की संख्या (आंशिक सहित)

completed_responsesinteger

पूर्ण रूप से भरे गए submissions की संख्या

completion_ratenumber

पूर्ण रिस्पॉन्स का प्रतिशत (0-100, 2 दशमलव तक)

average_completion_time_secondsinteger or null

पहले उत्तर से पूर्णता तक का औसत समय सेकंड में। कोई पूर्ण रिस्पॉन्स न होने पर null।

responses_by_dayarray

रिस्पॉन्स गणना का दैनिक breakdown

responses_by_day[].datestring

YYYY-MM-DD फॉर्मेट में तिथि

responses_by_day[].totalinteger

इस तिथि पर सबमिट किए गए कुल रिस्पॉन्स

responses_by_day[].completedinteger

इस तिथि पर पूर्ण किए गए रिस्पॉन्स

Response

json
{
  "form_id": "665a1b2c3d4e5f6a7b8c9d0e",
  "total_responses": 342,
  "completed_responses": 298,
  "completion_rate": 87.13,
  "average_completion_time_seconds": 194,
  "responses_by_day": [
    { "date": "2026-02-22", "total": 18, "completed": 16 },
    { "date": "2026-02-23", "total": 24, "completed": 21 },
    { "date": "2026-02-24", "total": 31, "completed": 27 },
    { "date": "2026-02-25", "total": 22, "completed": 20 },
    { "date": "2026-02-26", "total": 28, "completed": 25 },
    { "date": "2026-02-27", "total": 35, "completed": 30 },
    { "date": "2026-02-28", "total": 12, "completed": 11 }
  ]
}

कोड उदाहरण

bash
curl -X GET "https://api.nueform.io/api/v1/forms/665a1b2c3d4e5f6a7b8c9d0e/analytics?since=2026-02-01&until=2026-02-28" \
  -H "Authorization: Bearer YOUR_API_KEY"

क्वेरी टिप्स

Analytics के लिए तिथि सीमा नियंत्रित करने के लिए since और until query parameters का उपयोग करें।

पूरा इतिहास

फॉर्म के पूरे जीवनकाल का analytics प्राप्त करने के लिए since और until दोनों छोड़ दें।

पिछले 7 दिन

रोलिंग साप्ताहिक विंडो प्राप्त करने के लिए 7 दिन पहले की तिथि की गणना करें और इसे since parameter के रूप में पास करें।

विशिष्ट महीना

किसी विशिष्ट कैलेंडर महीने का analytics प्राप्त करने के लिए महीने के पहले और अंतिम दिन को since और until के रूप में पास करें।

पूरा इतिहास

bash
curl -X GET "https://api.nueform.io/api/v1/forms/665a1b2c3d4e5f6a7b8c9d0e/analytics" \
  -H "Authorization: Bearer YOUR_API_KEY"

पिछले 7 दिन

javascript
const since = new Date();
since.setDate(since.getDate() - 7);

const response = await fetch(
  `https://api.nueform.io/api/v1/forms/${formId}/analytics?since=${since.toISOString().split("T")[0]}`,
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);

विशिष्ट महीना

python
response = requests.get(
    f"https://api.nueform.io/api/v1/forms/{form_id}/analytics",
    params={"since": "2026-01-01", "until": "2026-01-31"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

Error Responses

इस endpoint द्वारा लौटाए गए मानक error responses।

Error Codes

400Bad Request

since या until के लिए अमान्य तिथि फॉर्मेट

401Unauthorized

API key गायब या अमान्य है

403Forbidden

टीम फॉर्म्स के लिए अपर्याप्त अनुमतियां

404Not Found

फॉर्म नहीं मिला

500Server Error

Internal server error

Error उदाहरण

json
{
  "error": "Form not found"
}
अंतिम अपडेट: 6 अप्रैल 2026