Conversations API: Retrieve and submit consumer-generated content (CGC), and retrieve your product catalog and statistics about your CGC.
Statistics Display
The Conversations API lets you programmatically retrieve and submit Bazaarvoice Conversations data for use in your applications. To learn more, go to the Conversations API documentation home page.
Contents
Returns Product-based Review Statistics. This method has been optimized and was created for inline ratings display.
Examples
Requesting native review statistics for one product
Requesting review statistics for one product
Requesting native review and review statistics for one product
Requesting native review and review statistics for multiple products
Requesting statistics on North American content for a given product
Parameters
Name | Description | Required | Default Value |
---|---|---|---|
PassKey |
API key is required to authenticate API user and check permission to access particular client's data. | Yes | |
ApiVersion |
The API version, e.g. 5.4. | Yes | |
Filter |
Filter criteria for content of the query. Must be Product IDs. | Yes | |
Stats |
The content type for which statistics should be included. Currently available types:
|
Yes | |
Callback |
Callback function name used with JSONP. Value is a string consisting of the following characters: a-z,A-Z,0-9,_ (excluding comma). See the JSONP tutorial for more information. |
No |
Filter options
- Each filter argument specifies the attribute to filter on followed by a comma-separated list of values. For instance, "Filter=ProductId:eq:Product1,Product2" returns statistics for Product1 and Product2.
- If a filter value contains a comma or a colon, that character needs to be escaped with a backslash (\, or \:). If a filter value contains an ampersand (&), the ampersand must be encoded in the filter value by replacing & with %26.
The following table lists the attributes available for filtering.
Name | Description |
---|---|
ContentLocale |
Locale of the content on which to calculate the statistics. A wildcard character "*" can be used to define the value, e.g., "en*" returns all content in English (en_US, en_CA, en_GB, etc.). The two valid operators for this filter are equals (eq) and not equals (neq). |
ProductId |
The indentifier for the products that will be returned in the results. This filter is required. A limit of 100 ProductIds exists when used in the Filter.
|
Response format
This is a sample response for requesting native review and review statistics for a product:
{ "Errors": [], "HasErrors": false, "Includes": {}, "Limit": 10, "Locale": "en_US", "Offset": 0, "Results": [ { "ProductStatistics": { "NativeReviewStatistics": { "AverageOverallRating": 5, "OverallRatingRange": 5, "TotalReviewCount": 1 }, "ProductId": "test3", "ReviewStatistics": { "AverageOverallRating": 3.8333, "OverallRatingRange": 5, "TotalReviewCount": 6 }, } ], "TotalResults": 1 }
Response elements
Name | Description |
---|---|
Includes |
Always empty
|
HasErrors |
Boolean indicating if the response had errors or not
|
Offset |
Dataset offset used for pagination (passed as URL parameter in a query request). The maximum supported value is 300000.
|
TotalResults |
Total number of records matched.
|
Errors |
Error section is populated instead of other fields if there is an error with a query syntax or problem executing a query.
|
Results |
Section containing an array of primitive type object references matched by a query.
|
Error codes
Value | Description |
---|---|
ERROR_PARAM_INVALID_API_KEY |
Invalid API Key value |
ERROR_PARAM_INVALID_FILTER_ATTRIBUTE |
Invalid filter attribute name |
ERROR_PARAM_INVALID_INCLUDED |
Invalid parameter value |
ERROR_PARAM_INVALID_CALLBACK |
Invalid JsonP callback function name |
ERROR_REQUEST_LIMIT_REACHED |
Rate limiting error, i.e. too many requests per time interval |
ERROR_UNSUPPORTED |
For unsupported features, clients etc. |
ERROR_ACCESS_DENIED |
Insufficient privileges to perform the operation |
ERROR_UNKNOWN |
Unknown error (internal server error, for instance) |