Analytics-API

Antwortkennzahlen und Abschluss-Analytics für deine Formulare abrufen.

Die Analytics-API liefert aggregierte Kennzahlen zu Formularantworten — inklusive Gesamtzahlen, Abschlussraten und täglichen Aufschlüsselungen.

Alle Antwort-Bodys verwenden Feldnamen in snake_case.

Formular-Analytics-Dashboard — Das Analytics-Dashboard mit Antwortkennzahlen und Abschlussraten.

Endpoints

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

Formular-Analytics abrufen

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

Gibt die Antwort-Analytics für ein bestimmtes Formular zurück. Optional kannst du auf einen Datumsbereich filtern, um bestimmte Zeiträume zu analysieren.

Pfad-Parameter

idstring

Die Formular-ID

Query-Parameter

sincestring

ISO-8601-Datum. Berücksichtigt nur Antworten, die an oder nach diesem Datum übermittelt wurden.

untilstring

ISO-8601-Datum. Berücksichtigt nur Antworten, die an oder vor diesem Datum übermittelt wurden.

Antwortfelder

form_idstring

Die Formular-ID

total_responsesinteger

Gesamtzahl der Übermittlungen (inklusive unvollständiger)

completed_responsesinteger

Anzahl der vollständig abgeschlossenen Übermittlungen

completion_ratenumber

Prozentsatz der abgeschlossenen Antworten (0-100, gerundet auf 2 Nachkommastellen)

average_completion_time_secondsinteger or null

Durchschnittliche Zeit in Sekunden von der ersten Antwort bis zum Abschluss. null, wenn es keine abgeschlossenen Antworten gibt.

responses_by_dayarray

Tägliche Aufschlüsselung der Antwortzahlen

responses_by_day[].datestring

Datum im Format YYYY-MM-DD

responses_by_day[].totalinteger

Gesamtzahl der an diesem Datum übermittelten Antworten

responses_by_day[].completedinteger

Abgeschlossene Antworten an diesem Datum

Antwort

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 }
  ]
}

Codebeispiele

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"

Tipps zur Abfrage

Nutze die Query-Parameter since und until, um den Datumsbereich der Analytics zu steuern.

Gesamter Verlauf

Lass sowohl since als auch until weg, um Analytics über die gesamte Lebensdauer des Formulars zu erhalten.

Letzte 7 Tage

Berechne das Datum vor 7 Tagen und übergib es als since-Parameter für ein rollierendes Wochenfenster.

Bestimmter Monat

Übergib den ersten und letzten Tag des Monats als since und until, um Analytics für einen bestimmten Kalendermonat zu erhalten.

Gesamter Verlauf

bash

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

Letzte 7 Tage

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" } }
);

Bestimmter Monat

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"},
)

Fehlerantworten

Standard-Fehlerantworten dieses Endpunkts.

Fehlercodes

400Bad Request

Ungültiges Datumsformat für since oder until

401Unauthorized

Fehlender oder ungültiger API-Schlüssel

403Forbidden

Unzureichende Berechtigungen für Team-Formulare

404Not Found

Formular nicht gefunden

500Server Error

Interner Serverfehler

Fehlerbeispiel

json

{
  "error": "Form not found"
}

Zuletzt aktualisiert: 20. Juli 2026