Surveys
What's that?Each survey is different and depends on your configuration : it can be composed of different answer type (stars, nps, multiple choices...).
Please go to/stats/survey to obtain the detail of your survey configuration.
Going furtherConsult the general Metrics API documentation for more.
How do I get my Survey metrics?
With /stats/survey
curl --location --request GET 'https://api.goodays.co/v2/stats/surveys/5gd0vbRYxL' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'{
"data": [
{
"key": "yLdLYMKp4j",
"description": "Did you easily find the products you were looking for?",
"count": 35,
"average": 3.6965811965811968,
"answers": [
{
"count": 1,
"percentage": 2.857142857142857,
"value": 1
},
{
"count": 4,
"percentage": 11.428571428571429,
"value": 2
},
{
"count": 7,
"percentage": 20.0,
"value": 3
},
{
"count": 17,
"percentage": 48.57142857142857,
"value": 4
},
{
"count": 6,
"percentage": 17.142857142857142,
"value": 5
}
]
},
{
"key": "bJdY1MKqdR",
"description": "What should we improve to fully satisfy you?",
"count": 35,
"average": 3.8098290598290596,
"answers": [
{
"count": 1,
"percentage": 2.857142857142857,
"value": "The reception"
},
{
"count": 3,
"percentage": 8.571428571428571,
"value": "Advice"
},
{
"count": 5,
"percentage": 14.285714285714285,
"value": "Waiting at the checkout"
},
{
"count": 20,
"percentage": 57.14285714285714,
"value": "The products on offer"
},
{
"count": 6,
"percentage": 17.142857142857142,
"value": "Availability of counsellors"
}
]
},
{
"key": "ELxjqQmr4K",
"description": "**Would you recommend** the VÉLO online store to your friends and family?",
"count": 35,
"average": 6.878205128205128,
"answers": [
{
"count": 0,
"percentage": 0.0,
"value": 0
},
{
"count": 1,
"percentage": 2.857142857142857,
"value": 1
},
{
"count": 5,
"percentage": 14.285714285714285,
"value": 2
},
{
"count": 2,
"percentage": 5.714285714285714,
"value": 3
},
{
"count": 1,
"percentage": 2.857142857142857,
"value": 4
},
{
"count": 1,
"percentage": 2.857142857142857,
"value": 5
},
{
"count": 0,
"percentage": 0.0,
"value": 6
},
{
"count": 8,
"percentage": 22.857142857142858,
"value": 7
},
{
"count": 6,
"percentage": 17.142857142857142,
"value": 8
},
{
"count": 7,
"percentage": 20.0,
"value": 9
},
{
"count": 4,
"percentage": 11.428571428571429,
"value": 10
}
]
}
]
}By default the calculation of the score is done "since always".
And the return will always contain:
| Attribute | Description |
|---|---|
| key | Survey ID |
| description | Description of the survey. |
| count | Number of participations. |
| average | Average score |
| answers | List of questions related to the survey selected. Each question lists the number of answers made on each answer option. The list is presented in the order of the choices proposed to the end customer. To know the order of the choices of a survey it is necessary to use the endpoint /stats/survey/{id}. |
| count | For each answers : number of participations with this answer. |
| percentage | Percentage of participations with this answer. |
| value | Choice wording. |
parameters
| Parameter | Description |
|---|---|
| id | Survey ID |
Available Question TypesGoodays supports a wide range of question formats, from standard text inputs to Emoji sentiment and nested conditional logic.
Head over to the Survey Question Types & Structures page to see exactly how each type is configured in the
optionsobject and how mother-daughter triggers work.
Add some filters
It is possible to add GET parameters to refine the calculation of the survey results over a defined period, a point of sale...
GET parameters
To filter the survey results, it is possible to combine the following GET parameters:
| GET parameters | Description |
|---|---|
| begin | Start date of the calculation period. Format : YYYY-MM-DDThh:mm:ssZ See this page for the timezone management. |
| end | End date of the calculation period. Format : YYYY-MM-DDThh:mm:ssZ See this page for the timezone management. |
| place | Filter on a point of sale. It is necessary to indicate the Place ID from the endpoint /places |
| places | Filter on a list of points of sale. Format : Place IDs separated by commas |
| level | Filter on a level. It is necessary to indicate the ID of the level from the endpoint /levels |
| levels | Filter on a level list. Format : Level IDs separated by commas |
Use cases
Here are some examples to show you the possibilities of this endpoint. This is obviously not exhaustive, it's up to you to have fun to find the right parameter arrangements :)
For one point of sale over the month of Octobre 2021
I have to use the following parameters :
- begin : the first date of the month of October
- end : the last date of the month of October
- place : the Place ID of the point of sale
curl --location --request GET 'https://api.goodays.co/v2/stats/surveys/My4lvMpK8R? \
begin=2021-10-01T00:00:00Z \
&end=2021-10-31T00:00:00Z \
&place=bwdQ661e4Q' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'{
"data": [
{
"key": "yLdLYMKp4j",
"description": "Did you easily find the products you were looking for?",
"count": 3,
"average": 3.6666666666666665,
"answers": [
{
"count": 2,
"percentage": 66.66666666666666,
"value": 5
},
{
"count": 1,
"percentage": 33.33333333333333,
"value": 1
}
]
},
{
"key": "bJdY1MKqdR",
"description": "What should we improve to fully satisfy you?",
"count": 3,
"average": 3.6666666666666665,
"answers": [
{
"count": 2,
"percentage": 66.66666666666666,
"value": 5
},
{
"count": 1,
"percentage": 33.33333333333333,
"value": 1
}
]
},
{
"key": "ELxjqQmr4K",
"description": "**Would you recommend** the VÉLO online store to your friends and family?",
"count": 3,
"average": 9.0,
"answers": [
{
"count": 1,
"percentage": 33.33333333333333,
"value": 8
},
{
"count": 1,
"percentage": 33.33333333333333,
"value": 9
},
{
"count": 1,
"percentage": 33.33333333333333,
"value": 10
}
]
}
]
}For two levels
have to use the following parameters :
- level : level ID
curl --location --request GET 'https://api.goodays.co/v2/stats/surveys/My4lvMpK8R? \
levels=Yqxzp5Ad2J,bQdPLrmwd9' \
--header 'Content-Type: application/json' \
--header 'Authorization: 1234abcd1234abcd1234abcd1234abcd'{
"data": [
{
"key": "yLdLYMKp4j",
"description": "Did you easily find the products you were looking for?",
"count": 66285,
"average": 4.625870534172204,
"answers": [
{
"count": 53073,
"percentage": 80.06788866259335,
"value": 5
},
{
"count": 8495,
"percentage": 12.815870860677379,
"value": 4
},
{
"count": 2778,
"percentage": 4.190993437429283,
"value": 1
},
{
"count": 1215,
"percentage": 1.8329938900203666,
"value": 3
},
{
"count": 724,
"percentage": 1.0922531492796257,
"value": 2
}
]
},
{
"key": "bJdY1MKqdR",
"description": "What should we improve to fully satisfy you?",
"count": 60779,
"average": 4.837596490103213,
"answers": [
{
"count": 53698,
"percentage": 88.34959443228747,
"value": 5
},
{
"count": 5860,
"percentage": 9.641488013952188,
"value": 4
},
{
"count": 558,
"percentage": 0.9180802579838431,
"value": 3
},
{
"count": 451,
"percentage": 0.7420326099475147,
"value": 1
},
{
"count": 212,
"percentage": 0.348804685828987,
"value": 2
}
]
},
{
"key": "ELxjqQmr4K",
"description": "**Would you recommend** the VÉLO online store to your friends and family?",
"count": 59159,
"average": 9.444679569107018,
"answers": [
{
"count": 41945,
"percentage": 70.9021450666847,
"value": 10
},
{
"count": 10274,
"percentage": 17.366757382646767,
"value": 9
},
{
"count": 4581,
"percentage": 7.743538599367805,
"value": 8
},
{
"count": 1112,
"percentage": 1.8796801839111545,
"value": 7
},
{
"count": 340,
"percentage": 0.5747223583901012,
"value": 5
},
{
"count": 285,
"percentage": 0.48175256512111425,
"value": 6
},
{
"count": 263,
"percentage": 0.44456464781351945,
"value": 0
},
{
"count": 99,
"percentage": 0.16734562788417653,
"value": 3
},
{
"count": 95,
"percentage": 0.16058418837370475,
"value": 2
},
{
"count": 90,
"percentage": 0.15213238898561504,
"value": 1
},
{
"count": 75,
"percentage": 0.12677699082134586,
"value": 4
}
]
}
]
}Updated 11 days ago
Did this page help you?