Contents

(+ show- hide)

This page describes the fundamental knowledge that you need in order to use the Product Sentiment Insights API.

HTTP service and data sets

The Product Sentiment Insights API differs from a traditional "REST" style API in that it consists of two distinct components which are described below:

HTTP service

The HTTP service refers to the HTTP interface that is used to request product sentiment insights data sets. Interaction with the HTTP service is a multi-step process that begins with requesting a resource that lists available manifest files, then requesting the desired manifest file, and finally requesting the data files as identified in the manifest file. The HTTP service is described in greater detail in the Workflow Walk-Through tutorial.

data sets

The data sets consist of data files in a compressed format containing product sentiment insights. Data sets are requested using the HTTP service. Unlike a traditional "REST" style API, these data sets are pre-calculated on a regular basis. Further, instead of representing a resource, each data file contains many lines of text that can be evaluated as a JSON object. Lear more about the data sets at the Reference

This hybrid architecture allows for speed at the cost of some flexibility. For example, we encourage you to perform multiple concurrent requests to the HTTP service. However, because the data sets are pre-computed, the HTTP service does not offer any filters or sorting options common to "REST" style APIs.

Environments

The Product Sentiment Insights API supports the following environments:

Environment Domain Description
Staging

https://stg.api.bazaarvoice.com

Used while developing your application.
Production

https://api.bazaarvoice.com

Used when your application is complete.

These environments use different API keys and as a result have independent rate limits. This allows you to develop applications using the staging environment without jeopardizing the stability of the production environment. However, both environments will return production data.

Versioning

The Product Sentiment Insights API exposes two version types: One for the HTTP service and another for the data sets. This allows you to retain control over how you interact with the Product Sentiment Insights API and decouples your implementation from future changes to the Product Sentiment Insights API until you are ready to upgrade.

This table shows all versions:

Version Release Date Deprecation Date Status

HTTP service version (identifies the structure of the URL path, query string parameters and headers)

v1 2019-02-01 TBD Latest

data sets version (identifies the structure of the data returned by the Product Sentiment Insights API)

v1 2019-02-01 TBD Latest
Latest
This is newest version. Feature development is focused on future versions, but we may perform backwards compatible bug fixes. New applications SHOULD use this version.

Data update intervals

Product Sentiment Insights API data is available in the following intervals:

Interval Manifest designation Description
At least weekly full Bazaarvoice will generate data sets at least once a week for all available content. You should completely replace your data store using the latest data files as they are available. This ensures that your data store does not fall out of sync with the Bazaarvoice network.

Credentials

The following required credentials will be provided by Bazaarvoice:

Type Description
Passkey A unique per-environment identifier included with each request. You will receive two passkeys, one for staging and one for production.
Shared Secret Used to encrypt the access signature. Known only to you and Bazaarvoice. You will receive two secrets, one for staging and one for production.

Next steps

Request access to the Product Sentiment Insights API.