You can combine a number of filters known as tags to select specific reviews you will like to collect stats on.

NB: This endpoint is currently not publicly accessible. Please reach out to your respective CSMs our account executive if you will like to use this API.

You can combine a number of filters known as tags to select specific reviews you will like to collect stats on.

Here is the list of supported tags:

  • Channel: You can include reviews belonging to a single or group of channels to be aggregated for the stats.

  • Event type (touchpoint): You can also filter out reviews based on the event type (touchpoint),

  • Metadata properties: You can get the stats based on specific metadata properties that you added when creating an event.

NB: Besides metadata properties, all other keywords must be prefixed with the $ sign to denote that they are reserved keywords within the system eg: channel should be $channel and touchpoint $touchpoint.
Also, stats are collected for only approved reviews.

Example

To fetch the stats for reviews belonging to the channel chl-abc and chl-xyz at touchpoint checkout and a productCategory of shoes from the metadata your request payload will look something like the one below:

Sample request payload in JSON (Click to view)
{
    "tags": [
    {
        "category": "$channel",
        "value": "chl-abc"
    },
    {
        "category": "$channel",
        "value": "chl-xyz"
    },
    {
        "category": "$touchpoint",
        "value": "checkout"
    },
    {
        "category": "productCategory",
        "value": "shoes"
    }
    ]
}
Language