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 further
Consult 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 responses. |
average | Average score |
answers | List of questions related to the survey selected. |
count | For each answers : number of responses for the answer. |
percentage | Percentage of responses for the answer. |
value | Choice wording. |
parameters
| Parameter | Description |
|---|---|
| id | Survey ID |
Add some filters
It is possible to add GET parameters to refine the calculation of the survey results over a defined period, an establishment...
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. |
end | End date of the calculation period. |
place | Filter on an establishment. |
places | Filter on an establishment list. |
level | Filter on a level. |
levels | Filter on a level list. |
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 establishment 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 ID of the establishment
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 18 days ago