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. 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 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. 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 an establishment. It is necessary to indicate the ID of the establishment from the endpoint /places |
| places | Filter on an establishment list. Format : Establishment IDs separated by commas |
| level | Filter on a level. It is necessary to indicate the ID of the establishment 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 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 about 1 year ago