Review Features

This page provides information about the review features data set. This data set allows you to discover what features consumers are using to talk about your products and services. A review feature is an aspect of a product, such as size or color, that Bazaarvoice has identified using natural language processing. Each feature contains information about positive, neutral, or negative sentiments mentioned, supporting opinion text, and a score that makes comparing features across your products easy.

📘

For products with more than 1000 reviews, only the most recent 1000 reviews will be incorporated into summaries.

📘

Non-English quotes may not contain highlighting.

Example

The following is a generalized example. Continue to the Fields section for information on each field, or view the Workflow Walk-Through tutorial to learn how to request this data set.

{  
  "productExternalId": "EMM60",  
  "category": "kids Accessories Football",  
  "feature": "size",  
  "featureTranslations": {  
    "fr": "taille",  
    "de": "Größe",  
    "es": "tamaño"  
  },  
  "brand": "Football",  
  "totalPositiveMentions": 1,  
  "totalNegativeMentions": 1,  
  "totalNeutralMentions": 1,  
  "incentivizedReviewsMentioned": 1,  
  "positiveQuotes": [  
    {  
      "id": "0UB6KrIoJ+ZYx2AH4IVWaEF0qhJXHoTn",  
      "sentenceId": "330300_2",  
      "text": "Belle coupe pour mon fils, très confortable et de la bonne taille",  
      "enTranslatedText": "Nice fit for my son, very comfortable and the right size",  
      "highlightedText": "Belle coupe pour mon fils, très confortable et de la bonne **taille**",  
      "reviewId": "1d1b85f2-9732-5399-bdd2-6f6ed41b1946",  
      "reviewLegacyId": "102326199",  
      "reviewRating": 5,  
      "nativeLanguage": "fr",  
      "isIncentivized": true,  
     "reviewDate": "2018-05-14T09:04:17+0000",  
      "author": "Rk71",  
      "highlights": [  
        {  
          "type": "opinion",  
          "startIndex": 0,  
          "endIndex": 64  
        },  
        {  
          "type": "feature",  
          "startIndex": 59,  
          "endIndex": 64  
        }  
      ]  
    }  
  ],  
  "negativeQuotes": [  
    {  
      "id": "UfFJU59BjVTRwXvg4KPSxPFHz4pdfLid",  
      "sentenceId": "53178_2",  
      "text": "Ces protège-tibias semblaient de bonne qualité mais étaient bien trop petits pour mon fils.",  
      "enTranslatedText": "These shin guards seemed good quality but were way too small for my son.",  
      "highlightedText": "Ces protège-tibias semblaient de bonne qualité mais étaient bien trop petits pour mon fils.",  
      "reviewId": "06938d11-c08f-5bff-8dad-5cc94804a136",  
      "reviewLegacyId": "104691971",  
      "reviewRating": 3,  
      "nativeLanguage": "fr",  
      "isIncentivized": false,  
      "reviewDate": "2018-08-31T21:15:52+0000",  
      "author": "Zon1212iek",  
      "highlights": [  
        {  
          "type": "opinion",  
          "startIndex": 0,  
          "endIndex": 90  
        }  
      ]  
    }  
  ],  
  "neutralQuotes": [  
    {  
      "id": "Pv6glcZ2BMVYDxAH4IVWaDtXK7KzDR6w",  
      "sentenceId": "312863_2",  
      "text": "Je me suis basé sur le tableau des tailles pour sélectionner la taille de mon fils, je devais lui donner du S.",  
      "enTranslatedText": "I based on the size chart to select the size for my son, I supposed to get S for him.",  
      "highlightedText": "Je me suis basé sur le tableau des tailles pour sélectionner la **taille** de mon fils, je devais lui donner du S.",  
      "reviewId": "2e3d50da-e203-58a5-ac19-46e91b94c46f",  
      "reviewLegacyId": "102745343",  
      "reviewRating": 1,  
      "nativeLanguage": "fr",  
      "isIncentivized": false,  
      "reviewDate": "2018-06-03T12:35:38+0000",  
      "author": "Lun1214",  
      "highlights": [  
        {  
         "type": "opinion",  
          "startIndex": 0,  
          "endIndex": 109  
        },  
        {  
          "type": "feature",  
          "startIndex": 64,  
          "endIndex": 69  
        }  
      ]  
    }  
  ],  
  "score": 5.57,  
  "client": "example-client",  
  "categoryId": "kids-Accessories-Football"  
}

Fields

productExternalId

"productExternalId": "EMM60"

The client's unique identifier for the product.


category

"category": "kids Accessories Football"

The category that the reviewed product belongs to.


feature

"feature": "size"

The aspect of a product that is mentioned within the opinion text. Bazaarvoice uses natural language processing to automatically identify features from review text. There is no fixed feature dictionary and features may differ between categories (for example, “picture quality” is a feature of televisions but not of socks).


featureTranslations

 "featureTranslations": {  
    "fr": "taille",  
    "de": "Größe",  
    "es": "tamaño"  
  }

The French, German and Spanish translations of this feature.


brand

"brand": "Football"

The brand the product belongs to.


totalPositiveMentions

"totalPositiveMentions": 1

The total number of positive mentions associated with the feature across all reviews for the product.


totalNegativeMentions

"totalNegativeMentions": 1

The total number of negative mentions associated with the feature across all reviews for the product.


totalNeutralMentions

"totalNeutralMentions": 1

The total number of neutral mentions associated with the feature across all reviews for the product.


incentivizedReviewsMentioned

"incentivizedReviewsMentioned": 1

The number of incentivized reviews that include a mention of this feature for the product.


positiveQuotes

"positiveQuotes": [  
    {  
      "id": "0UB6KrIoJ+ZYx2AH4IVWaEF0qhJXHoTn",  
      "sentenceId": "330300_2",  
      "text": "Belle coupe pour mon fils, très confortable et de la bonne taille",  
      "enTranslatedText": "Nice fit for my son, very comfortable and the right size",  
      "highlightedText": "Belle coupe pour mon fils, très confortable et de la bonne **taille**",  
      "reviewId": "1d1b85f2-9732-5399-bdd2-6f6ed41b1946",  
      "reviewLegacyId": "102326199",  
      "reviewRating": 5,  
      "nativeLanguage": "fr",  
      "isIncentivized": true,  
      "reviewDate": "2018-05-14T09:04:17+0000",  
      "author": "Rk71",  
      "highlights": [  
        {  
          "type": "opinion",  
          "startIndex": 0,  
          "endIndex": 64  
        },  
        {  
          "type": "feature",  
          "startIndex": 59,  
          "endIndex": 64  
        }  
      ]  
    }  
  ]

An object containing up to five positive quotes associated with the feature. The feature associated with the quote is highlighted with HTML <strong> tags within the highlightedText field. The number of quotes returned may not match the number of totalPositiveMentions if some of the quotes do not meet our quality requirements or if the number of quotes exceeds the limit of five objects to return.


negativeQuotes

 "negativeQuotes": [  
    {  
      "id": "UfFJU59BjVTRwXvg4KPSxPFHz4pdfLid",  
      "sentenceId": "53178_2",  
      "text": "Ces protège-tibias semblaient de bonne qualité mais étaient bien trop petits pour mon fils.",  
      "enTranslatedText": "These shin guards seemed good quality but were way too small for my son.",  
      "highlightedText": "Ces protège-tibias semblaient de bonne qualité mais étaient bien trop petits pour mon fils.",  
      "reviewId": "06938d11-c08f-5bff-8dad-5cc94804a136",  
      "reviewLegacyId": "104691971",  
      "reviewRating": 3,  
      "nativeLanguage": "fr",  
      "isIncentivized": false,  
      "reviewDate": "2018-08-31T21:15:52+0000",  
      "author": "Zon1212iek",  
      "highlights": [  
        {  
          "type": "opinion",  
          "startIndex": 0,  
          "endIndex": 90  
        }  
      ]  
    }  
  ]

An object containing up to five negative quotes associated with the feature. The feature associated with the quote is highlighted with HTML <strong> tags within the highlightedText field. The number of quotes returned may not match the number of totalNegativeMentions if some of the quotes do not meet our quality requirements or if the number of quotes exceeds the limit of five objects to return.


neutralQuotes

"neutralQuotes": [  
    {  
      "id": "Pv6glcZ2BMVYDxAH4IVWaDtXK7KzDR6w",  
      "sentenceId": "312863_2",  
      "text": "Je me suis basé sur le tableau des tailles pour sélectionner la taille de mon fils, je devais lui donner du S.",  
      "enTranslatedText": "I based on the size chart to select the size for my son, I supposed to get S for him.",  
      "highlightedText": "Je me suis basé sur le tableau des tailles pour sélectionner la **taille** de mon fils, je devais lui donner du S.",  
      "reviewId": "2e3d50da-e203-58a5-ac19-46e91b94c46f",  
      "reviewLegacyId": "102745343",  
      "reviewRating": 1,  
      "nativeLanguage": "fr",  
      "isIncentivized": false,  
      "reviewDate": "2018-06-03T12:35:38+0000",  
      "author": "Lun1214",  
      "highlights": [  
        {  
          "type": "opinion",  
          "startIndex": 0,  
          "endIndex": 109  
        },  
        {  
          "type": "feature",  
          "startIndex": 64,  
          "endIndex": 69  
        }  
      ]  
    }  
  ]

An object containing up to five neutral quotes associated with the feature. The feature associated with the quote is highlighted with HTML <strong> tags within the highlightedText field. The number of quotes returned may not match the number of totalNeutralMentions if some of the quotes do not meet our quality requirements or if the number of quotes exceeds the limit of five objects to return.


id

"id": "0UB6KrIoJ+ZYx2AH4IVWaEF0qhJXHoTn"

The unique identifier of the quote.


sentenceId

"sentenceId": "330300_2"

The unique identifier of the sentence the quote is extracted from.


text

"text": "Belle coupe pour mon fils, très confortable et de la bonne taille"

The text content of the quote.


enTranslatedText

 "enTranslatedText": "Nice fit for my son, very comfortable and the right size"

The English translation of the text content of the quote. For English language quotes, "enTranslatedText" is the same as "text"


highlightedText

"highlightedText": "Belle coupe pour mon fils, très confortable et de la bonne taille"

The text content of the quote with HTML <strong> tags emphasizing the product features the quote refers to, such as size or color.

reviewId

"reviewId": "1d1b85f2-9732-5399-bdd2-6f6ed41b1946"

The unique identifier of the review the quote is a part of.


reviewLegacyId

"reviewLegacyId": "102326199"

The unique identifier previously used by Bazaarvoice to identify the review.


reviewRating

"reviewRating": 5

The overall rating of the review.


nativeLanguage

"nativeLanguage": "fr"

The native language of the review from which this quote was extracted.


isIncentivized

 "isIncentivized": true

The incentivized status of the review from which this quote was extracted. If true, the review was incentivized.


reviewDate

"reviewDate": "2018-05-14T09:04:17+0000"

The submission date of the review.


author

"author": "Rk71"

The username of the review author.


highlights

"highlights": [  
  {  
    "type": "opinion",  
    "startIndex": 0,  
    "endIndex": 64  
  },  
  {  
    "type": "feature",  
    "startIndex": 59,  
    "endIndex": 64  
  }  
]

Start and end indices of the quotes. Highlights of type "opinion" are for identifying entire sentences that mention the feature. Highlights of type "feature" are for identifying individual mentions of the feature within sentences. The startIndex is the 0-based index of the first character of the sentence or feature mention. The endIndex is the 0-based index of the last character of the sentence or feature mention.


score

"score": 5.57

A rating from 0 (negative) to 10 (positive) that considers the volume of positive feature mentions and the ratio of positive feature mentions to all feature mentions. This rating is derived only from sentiment analysis and is not tied to the overall rating of the review.


client

"client": "example-client"

The client from which the review is sourced.


categoryId

"categoryId": kids-Accessories-Football

The unique identifier for the category.