📘

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:

AttributeDescription
key Survey ID
description Description of the survey.
countNumber of responses.
average Average score
answersList 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}.
countFor each answers : number of responses for the answer.
percentagePercentage of responses for the answer.
valueChoice wording.

parameters

ParameterDescription
idSurvey 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 parametersDescription
beginStart date of the calculation period.
Format : YYYY-MM-DDThh:mm:ssZ
See this page for the timezone management.
endEnd date of the calculation period.
Format : YYYY-MM-DDThh:mm:ssZ
See this page for the timezone management.
placeFilter on an establishment.
It is necessary to indicate the ID of the establishment from the endpoint /places
placesFilter on an establishment list.
Format : Establishment IDs separated by commas
levelFilter on a level.
It is necessary to indicate the ID of the establishment from the endpoint /levels
levelsFilter 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
                }
            ]
        }
    ]
}