Votes

Votes data type

The Votes data type is quite different from the Feedback one for the main reason that it lacks a specific reference: on web-shops Votes are shown as a global reference and we can’t isolate each vote, there is no author and no time reference and most of the time there is no specific indication of the product variant each Vote refers to.

When we scrape Votes on a product page we take a photo, a snapshot of the Votes breakdown, total number and average rating at that precise moment, and we store it in our data lake.

Date field

The date field in the Votes data type is the date when the votes were collected. This date is not the date when the votes were submitted, but the date when the votes were collected and aggregated.

For more information about the Votes data type and how it differs from the Feedback data type please refer to the Wonderflow Academy page.

Use cases

Here some of the most popular use-cases for retrieving feedback.

This API will provide you all the Votes snapshots from all the products in your scope. This will be useful to get a complete overview of the Votes KPIs trend over time by collecting data incrementally.

POST /v3/votes

The response will include the number of Votes and Votes average rating and respective deltas associated with the specified SKU, along withe the channel, country, brand, and other relevant information.

{
  "total": 12345,
  "votes": [
    {
      "_id" : ObjectId("67bf2019dc4e9452ea82bed4"),
      "pageId" : "15502038",
      "productId" : ObjectId("67bd9b648a870a6a4aa5f960"),
      "sku" : "L50BS23",
      "avgRating" : 4.4,
      "numberOfRatings" : 210,
      "deltaAvgRating" : 4.1,
      "deltaNumberOfRatings" : 10,
      "breakdown" : {
          "1" : 9,
          "2" : 4,
          "3" : 16,
          "4" : 49,
          "5" : 132
      },
      "channel" : "currys.co.uk",
      "country" : "United Kingdom",
      "ingestionDate": "2025-02-25T12:00:00.000Z"
    }, {
      "_id" : ObjectId("67bf2019dc4e9452ea82bed3"),
      "pageId" : "15502038",
      "pageUrl" : "https://www.currys.co.uk/products/l50bs23.html",
      "productId" : ObjectId("67bd9b648a870a6a4aa5f960"),
      "sku" : "L50BS23",
      "avgRating" : 4.5,
      "numberOfRatings" : 200,
      "deltaAvgRating" : 4.4,
      "deltaNumberOfRatings" : 33,
      "breakdown" : {
          "1" : 9,
          "2" : 2,
          "3" : 8,
          "4" : 49,
          "5" : 132
      },
      "channel" : "currys.co.uk",
      "country" : "United Kingdom",
      "ingestionDate": "2025-01-25T12:00:00.000Z"
    }, ...
  ]
}

This API will provide you all the Votes snapshots from all the products in your scope. This will be useful to get a complete overview of the Votes KPIs trend over time.

POST /v3/votes

{
  "total": 12345,
  "votes": [
    {
      "_id" : ObjectId("67bf2019dc4e9452ea82bed4"),
      "pageId" : "15502038",
      "productId" : ObjectId("67bd9b648a870a6a4aa5f960"),
      "sku" : "L50BS23",
      "avgRating" : 4.4,
      "numberOfRatings" : 210,
      "deltaAvgRating" : 4.1,
      "deltaNumberOfRatings" : 10,
      "breakdown" : {
          "1" : 9,
          "2" : 4,
          "3" : 16,
          "4" : 49,
          "5" : 132
      },
      "channel" : "currys.co.uk",
      "country" : "United Kingdom",
      "ingestionDate": "2025-02-25T12:00:00.000Z"
    },  ...
  ]
}

This endpoint is deprecated and we recommend to use the new /v3/votes endpoint

To obtain all the votes associated with your scope you can use the following endpoint:

GET /v1/votes

The response will include the number of Votes and Votes average rating associated with the specified SKU, along withe the channel, country, brand, and other relevant information.

{
  "total": 2,
  "votes": [
    {
      "channel": "amazon.it",
      "country": "Italy",
      "sku": "ASGE999/00",
      "brand": "Philips",
      "numberOfVotes": 13889,
      "averageRating": 4.2,
      "date": "2025-02-25T12:00:00.000Z"
    }, {
      "channel": "amazon.it",
      "country": "Italy",
      "sku": "ASGE999/00",
      "brand": "Philips",
      "numberOfVotes": 4827,
      "averageRating": 3.9,
      "date": "2025-02-25T12:00:00.000Z"
    }
  ]
}

The endpoint will return ONLY the latest votes scraped in the last week, all the other values will be forced to 0.

This means that if the scraping ran on the 12nd of February and you call the endpoint on the 25th of February, the API will return all the Votes records but their value of numberOfVotes and averageRating will be forced to 0.

{
  "total": 0,
  "votes": [
    {
      "channel": "canadiantire.ca",
      "country": "Canada",
      "sku": "2513N",
      "brand": "Bissell",
      "numberOfVotes": 0,
      "averageRating": 0,
      "date": "2025-02-25T12:00:00.000Z"
    },
    {
      "channel": "canadiantire.ca",
      "country": "Canada",
      "sku": "3369N",
      "brand": "Bissell",
      "numberOfVotes": 0,
      "averageRating": 0,
      "date": "2025-02-25T12:00:00.000Z"
    }, ...
  ]
}

API Documentation

Token

Feedback

Page

Product

Analytics

Brand

Channel

User

Votes

Votes data type

Date field

Use cases

API Documentation

Token

Feedback

Votes

Page

Product

Analytics

Brand

Channel

User

​Votes data type

​Date field

​Use cases

Votes data type

Date field

Use cases