---
title: Supported Content
layour: layout.html
---

# Supported Content

Using the Wonderflow API, you can access the following content:

- [Catalog](#catalog) - The list of all products or services that are interesting for your organization 
- [Pros & Cons](#pros-cons) - Sentiment analytics about each aspect of a product or service, to see how consumers are satisfied on every single detail of the interesting product or service
- [Rating Breakdown](#rating-breakdown) - The star ratings that illustrates overall how consumers are satisfied with the overall performance of the product 
- [Review excerpt](#review-excerpt)

<a name="catalog"></a>
## Catalog

The Catalog API allows you to access the **list of all the products and services** that are interesting for your organization.

Each item of the catalog includes the following information: 

- Brand name - the brand of the product or service
- Product name - the name of the product or service
- Countries - in which a product or service is commented on
- Channels - in which a product or service is commented on
- Average Rating - the average rating calculated worldwide and the number of reviews that are online for the specific product
- Image URL - the URL of the official image representing the product
- Category: the category the product belongs to

An example of the JSON presentation that the API will return to you is:

```json
{
   "id": "5415e31506199ce8296741cb",
   "productName": "Nutrish Chicken & Vegetable",
   "brandName": "Purina",
   "imageUrl": "https://dashboard.wonderflow.co/product-images/rachael_ray_nutrish_chicken_vegetable.jpg",
   "avgRating": 4.7,
   "countries": [
       "United States"
   ],
   "channels": [
       "walmart.com",
       "amazon.com"
   ],
   "category": "Dry food"
}
```

An example of visualization that you can build from an item of the Catalog:

<img src="/images/example-product.png" alt="Example of visualization" width="200" />

<a name="pros-cons"></a>
## Pros & Cons

The Pros & Cons API allows you to access **aspect-based sentiment analytics** about products and services.

With the information that it returns, you can show how every single product feature is performing and is perceived, eventually in specific countries, channels, categories or brands. 

For example, given the product “Purina - Nutrish Chicken & Vegetable”, you can access which is the sentiment that the consumers have expressed regarding the impact of the product on the “Allergies”, or the “Weight” of their dog.

The aspects that you can have the sentiment about depends on the category of the product or service.

For the "Dog Food" category the list of aspect is:

- "Coat & skin"
- "Overall health"
- "Weight"
- "Stomach"
- "Allergies"
- "Bowel movement"
- "Quality"
- "Packaging"
- "Meets expectations"
- "Flavor"
- "Communication"
- "Overall satisfaction"
- "Price"
- "Delivery"
- "Recommendation"
- "Brand perception"


An example of data that the API return is:


```json

{
       "id": "5415e31506199ce8296741cb",
       "brandName": "Purina",
       "productName": "Nutrish Chicken & Vegetable",
       "countries": [
           "United States"
       ],
       "channels": [
           "walmart.com",
           "amazon.com"
       ],
       "prosCons": [
           "flavor": {
               "numberOfPositiveReviews": 209,
               "numberOfNegativeReviews": 13,
               "numberOfNeutralReviews": 0,
               "percentageOfPositiveReviews": 69,
               "percentageOfNegativeReviews": 4,
               "percentageOfNeutralReviews": 0
           },
           "weight": {
               "numberOfPositiveReviews": 9,
               "numberOfNegativeReviews": 1,
               "numberOfNeutralReviews": 0,
               "percentageOfPositiveReviews": 3,
               "percentageOfNegativeReviews": 0,
               "percentageOfNeutralReviews": 0
           },
           "stomach": {
               "numberOfPositiveReviews": 42,
               "numberOfNegativeReviews": 7,
               "numberOfNeutralReviews": 0,
               "percentageOfPositiveReviews": 14,
               "percentageOfNegativeReviews": 2,
               "percentageOfNeutralReviews": 0
           }
       ]
   }
   
```
 

An example of visualization that you can build with the Pros & Cons data follows:

<img src="/images/example-pros-cons.png" width="400" />

<a name="rating-breakdown"></a>
## Rating Breakdown

The Rating Breakdown API allows you to access data that you can use to quickly show **how the consumers are satisfied with the overall performance of the product**.

You can access how many consumers have given a 1 star rating, how many 2 star rating, etc.

The scale of the rating is from 1 to 5.

An example of data that the API returns is:

```json
{
       "id": "5415e31506199ce8296741cb",
       "brandName": "Purina",
       "productName": "Nutrish Chicken & Vegetable",
       "countries": [
           "United States"
       ],
       "channels": [
           "walmart.com"
       ],
       "totalNumberOfReviews": 448,
       "ratingBreakdown": {
           "1": 55,
           "2": 60,
           "3": 3,
           "4": 150,
           "5": 180
       }
   }
```


An example of visualization that you can build with it follows:

<img src="/images/example-rating-breakdown.png" width="400" />

<a name="review-excerpt"></a>
## Review excerpt 

The review excerpt API will allow you to access **a part of the review** to visualize on the website (the accepted length of the review still needs to be confirmed by Purina). The review excerpt will contain 

- The review title 
- A part of the review to allow users to read
- Link to review source 
- Link to buy product * this still needs to be evaluated due to the legality. Therefore, this requirement is subject to change.