Reviews

The Reviews endpoint allows viewing reviews and comments. This end point allows reviews to be viewed for Apps, Stories OR Pathways.

Streams items do not use the reviews endpoint, instead use the /analytics/stream-ratings endpoint.

Available Reviews Endpoints

v1/analytics/reviews/apps Get reviews for all content published for an app or a list of apps.

v1/analytics/reviews/pathways Get reviews for a pathway or a list of pathways.

v1/analytics/reviews/stories Get reviews for a story or a list of stories.

Parameters

The items parameter allows you to filter items based on the name or ID of the item. If the item parameter is not provided the endpoint will return the latest 10 items.

Parameters

The items parameter allows you to filter items based on the name or ID of the item. If the item parameter is not provided the endpoint will return the latest 10 items.

Key

Value

items

Array of Strings Item name or ID

Examples

Get All Content Reviews On An App

The example below retrieves all story and pathway reviews for a given app.

curl -X POST \
  v1/analytics/reviews/apps \
  -H 'Authorization: Basic <Your Base64 Encoded Token>'\
  -d '{
    "items" : ["Falkor"]
  }'

Get Reviews On Several Stories

The example below retrieves reviews for a collection of stories.

curl -X POST \
  v1/analytics/reviews/stories \
  -H 'Authorization: Basic <Your Base64 Encoded Token>'\
  -d '{
    "items" : ["Story A","Story B","Story C",...]
  }'

Success Response

Whichever reviews endpoint you are using a successful response will return an array of items with each item containing a context item (app, pathway or story) and corresponding reviews data. The example below shows a successful response when using the reviews/apps endpoint.

Review Item

Key

Value

Ratings

Object With average rating and number of users that have rated the content.

Comments

Array Comment Items

Comment Item

Key

Value

firstname

String

lastname

String

email

String

telephone

String

country

String

city

String

comment

String

timestamp

String

item

Object The related content item

{
    "status": "success",
    "data": [
        {
            "app": {
                "name": "Falkor",
                "version": "2.10.1",
                "type": "app",
                "ID": "io.falkor.demo"
            },
            "reviews": {
                "ratings": {
                    "average": 4.3,
                    "users": 10427
                },
                "comments": [
                    {
                        "firstname": "User",
                        "lastname": "One",
                        "email": "user.one@acme.com",
                        "telephone": "",
                        "country": "United Kingdom",
                        "city": "London",
                        "rating": 4,
                        "comment": "This is great thanks! 😀",
                        "timestamp": "2021-03-12T16:59:42+02:00",
                        "item": {
                            "type": "story",
                            "name": "Workplace Culture"
                        }
                    },
                    {
                        "firstname": "User",
                        "lastname": "Two",
                        "email": "user.two@acme.com",
                        "telephone": "",
                        "country": "********",
                        "city": "********",
                        "rating": 5,
                        "comment": "This was very informative - 5 Stars",
                        "timestamp": "2021-03-12T16:12:06+02:00",
                        "item": {
                            "type": "pathway",
                            "name": "Onboarding Pathway"
                        }
                    },
                    ...etc
                ]
            }
        },
        ...etc
    ],
    "hash": "67d5e81356c9ad8f419e38cfbbb6b396",
    "response_time": 0.19236993789672852
}

Last updated