Contents

(+ show- hide)

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 reviews from the last two years will be incorporated into features.
Products must have a minimum of 10 reviews to have product sentiment insights created.

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",
  "brand": "Adidas Football",
  "totalPositiveMentions": 1,
  "totalNegativeMentions": 1,
  "totalNeutralMentions": 1,
  "positiveQuotes": [
    {
      "id": "0UB6KrIoJ+ZYx2AH4IVWaEF0qhJXHoTn",
      "sentenceId": "330300_2",
      "text": "Nice fit for my son, very comfortable and the right size",
      "highlightedText": "Nice fit for my son, very comfortable and the right size",
      "reviewId": "1d1b85f2-9732-5399-bdd2-6f6ed41b1946",
      "reviewLegacyId": "102326199",
      "reviewRating": 5,
      "reviewDate": "2018-05-14T09:04:17+0000",
      "author": "Rk71",
      "highlights": [
        {
          "type": "opinion",
          "startIndex": 0,
          "endIndex": 55
        },
        {
          "type": "feature",
          "startIndex": 52,
          "endIndex": 55
        }
      ]
    }
  ],
  "negativeQuotes": [
    {
      "id": "UfFJU59BjVTRwXvg4KPSxPFHz4pdfLid",
      "sentenceId": "53178_2",
      "text": "These shin guards seemed good quality but were way too small for my son.",
      "highlightedText": "These shin guards seemed good quality but were way too small for my son.",
      "reviewId": "06938d11-c08f-5bff-8dad-5cc94804a136",
      "reviewLegacyId": "104691971",
      "reviewRating": 3,
      "reviewDate": "2018-08-31T21:15:52+0000",
      "author": "Zon1212iek",
      "highlights": [
        {
          "type": "opinion",
          "startIndex": 0,
          "endIndex": 71
        },
        {
          "type": "feature",
          "startIndex": 55,
          "endIndex": 59
        }
      ]
    }
  ],
  "neutralQuotes": [
    {
      "id": "Pv6glcZ2BMVYDxAH4IVWaDtXK7KzDR6w",
      "sentenceId": "312863_2",
      "text": "I based on the size chart to select the size for my son, I supposed to get S for him.",
      "highlightedText": "I based on the size chart to select the size for my son, I supposed to get S for him.",
      "reviewId": "2e3d50da-e203-58a5-ac19-46e91b94c46f",
      "reviewLegacyId": "102745343",
      "reviewRating": 1,
      "reviewDate": "2018-06-03T12:35:38+0000",
      "author": "Lun1214",
      "highlights": [
        {
          "type": "opinion",
          "startIndex": 0,
          "endIndex": 84
        },
        {
          "type": "feature",
          "startIndex": 15,
          "endIndex": 18
        },
        {
          "type": "feature",
          "startIndex": 40,
          "endIndex": 43
        }
      ]
    }
  ],
  "score": 5.57,
  "client": "adidasglobal",
  "categoryId": "kids-Accessories-Football"
}

Fields

productExternalId

"productExternalId": "2891130"

The client's unique identifier for the product.


category

"category": "kids Accessories Football"

The category that the reviewed product belongs to.


feature

"feature": "appearance"

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).


brand

"brand": "Adidas Football"

The brand the product belongs to.


totalPositiveMentions

"totalPositiveMentions": 3

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


totalNegativeMentions

"totalNegativeMentions": 3

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


totalNeutralMentions

"totalNeutralMentions": 3

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


positiveQuotes

"positiveQuotes": [
  {
    "id": "0UB6KrIoJ+ZYx2AH4IVWaEF0qhJXHoTn",
    "sentenceId": "330300_2",
    "text": "Nice fit for my son, very comfortable and the right size",
    "highlightedText": "Nice fit for my son, very comfortable and the right size",
    "reviewId": "1d1b85f2-9732-5399-bdd2-6f6ed41b1946",
    "reviewLegacyId": "102326199",
    "reviewRating": 5,
    "reviewDate": "2018-02-14T09:04:17+0000",
    "author": "author1",
    "highlights": [
      {
        "type": "opinion",
        "startIndex": 0,
        "endIndex": 55
      },
      {
        "type": "feature",
        "startIndex": 52,
        "endIndex": 55
      }
    ]
  }
]

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": "These shin guards seemed good quality but were way too small for my son.",
    "highlightedText": "These shin guards seemed good quality but were way too small for my son.",
    "reviewId": "06938d11-c08f-5bff-8dad-5cc94804a136",
    "reviewLegacyId": "104691971",
    "reviewRating": 3,
    "reviewDate": "2015-08-31T21:15:52+0000",
    "author": "author2",
    "highlights": [
      {
        "type": "opinion",
        "startIndex": 0,
        "endIndex": 71
      },
      {
        "type": "feature",
        "startIndex": 55,
        "endIndex": 59
      }
    ]
  }
]

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": "I based on the size chart to select the size for my son, I supposed to get S for him.",
    "highlightedText": "I based on the size chart to select the size for my son, I supposed to get S for him.",
    "reviewId": "2e3d50da-e203-58a5-ac19-46e91b94c46f",
    "reviewLegacyId": "102745343",
    "reviewRating": 1,
    "reviewDate": "2013-06-03T12:35:38+0000",
    "author": "author2",
    "highlights": [
      {
        "type": "opinion",
        "startIndex": 0,
        "endIndex": 84
      },
      {
        "type": "feature",
        "startIndex": 15,
        "endIndex": 18
      },
      {
        "type": "feature",
        "startIndex": 40,
        "endIndex": 43
      }
    ]
  }
]

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": "VgJ5KB1kSklYD2AH4IVWaDtXK7KzDR6w"

The unique identifier of the quote.


sentenceId

"sentenceId": "316463_3"

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


text

"text": "But once I got it I realialize they were so small and acording to size chart on the item I should be ordering L for my son."

The text content of the quote.


highlightedText

"highlightedText": "But once I got it I realialize they were so small and acording to size chart on the item I should be ordering L for my son."

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": "2d040312-a401-5e9e-b86f-fdeaa023e032"

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


reviewLegacyId

"reviewLegacyId": "3489734898"

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


reviewRating

"reviewRating": 2

The overall rating of the review.


reviewDate

"reviewDate": "2011-06-03T12:35:38+0000"

The submission date of the review.


author

"author": "PhotoNut7"

The username of the review author.


highlights

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

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": "acme"

The client from which the review is sourced.


categoryId

"categoryId": 1001

The unique identifier for the category.