curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/questions/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
[
{ "question": "Name", "type": "shortAnswer", "answered": 38, "response_rate": 100.0 },
{
"question": "Where would you like to sit?",
"type": "multipleChoice",
"answered": 30,
"response_rate": 78.9,
"distribution": [
{ "label": "Terrace", "count": 21 },
{ "label": "Inside", "count": 9 },
{ "label": "Bar", "count": 0 }
]
},
{
"question": "How was your last visit?",
"type": "starRating",
"answered": 25,
"response_rate": 65.8,
"distribution": [
{ "label": "5", "count": 14 },
{ "label": "4", "count": 8 },
{ "label": "3", "count": 3 }
]
}
]
Prospects et formulaires
Obtenir les analyses de formulaire par question
GET /forms//analytics/questions/
GET
/
forms
/
{form_id}
/
analytics
/
questions
/
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/questions/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
[
{ "question": "Name", "type": "shortAnswer", "answered": 38, "response_rate": 100.0 },
{
"question": "Where would you like to sit?",
"type": "multipleChoice",
"answered": 30,
"response_rate": 78.9,
"distribution": [
{ "label": "Terrace", "count": 21 },
{ "label": "Inside", "count": 9 },
{ "label": "Bar", "count": 0 }
]
},
{
"question": "How was your last visit?",
"type": "starRating",
"answered": 25,
"response_rate": 65.8,
"distribution": [
{ "label": "5", "count": 14 },
{ "label": "4", "count": 8 },
{ "label": "3", "count": 3 }
]
}
]
Renvoie la façon dont chaque question d’un formulaire a été renseignée, dans l’ordre des questions du formulaire : combien de réponses y ont répondu, quelle part des réponses cela représente et — pour les questions à choix, de notation et d’échelle — combien de fois chaque réponse a été donnée.
Nécessite une clé d’API de gestion avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) et la permission LEAD_GENERATION_ANALYTICS_CAN_VIEW, envoyée comme valeur brute de l’en-tête Authorization — voir la présentation de l’API de gestion.string
requis
Le
form_id du formulaire.string
Ne compte que les réponses reçues à cette date ou après (
YYYY-MM-DD).string
Ne compte que les réponses reçues à cette date ou avant (
YYYY-MM-DD).string
Ne compte que les réponses soumises via ce code QR (son
qrid).curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/questions/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
[
{ "question": "Name", "type": "shortAnswer", "answered": 38, "response_rate": 100.0 },
{
"question": "Where would you like to sit?",
"type": "multipleChoice",
"answered": 30,
"response_rate": 78.9,
"distribution": [
{ "label": "Terrace", "count": 21 },
{ "label": "Inside", "count": 9 },
{ "label": "Bar", "count": 0 }
]
},
{
"question": "How was your last visit?",
"type": "starRating",
"answered": 25,
"response_rate": 65.8,
"distribution": [
{ "label": "5", "count": 14 },
{ "label": "4", "count": 8 },
{ "label": "3", "count": 3 }
]
}
]
response_rateexprimeanswereden pourcentage des réponses reçues par le formulaire sur la période, arrondi à une décimale. Les soumissions omises ne sont pas des réponses et ne sont pas comptées.distributionn’apparaît que pour les questions à choix (multipleChoice,checkbox,dropdown), les notations (starRating,emoji,likeDislike) et les échelles (linearScale,number). Pour les questions à choix, toutes les options sont listées, y compris celles que personne n’a choisies, de la plus choisie à la moins choisie. Une réponsecheckboxcompte une fois pour chaque option cochée.- Les blocs de contenu purement affichés ne sont pas des questions et n’apparaissent pas.
Voir aussi
- Obtenir les analyses de formulaire — les totaux de réponses et d’omissions dans le temps, et les réponses par source.
- Lister les réponses de formulaire — les soumissions individuelles derrière ces chiffres.
- Présentation de l’API de gestion — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. 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.
Paramètres de chemin
The form's form_id.
Paramètres de requête
Only responses on or after this date (YYYY-MM-DD).
Only responses on or before this date (YYYY-MM-DD).
Only responses submitted through this QR Code (qrid).
Cette page vous a-t-elle été utile ?