🚧

Only API keys on our Conversations PRR platform are eligible to use this API version. Refer to the Platforms section of our Platform & API Concepts documentation to learn which platform your API keys are on.

Returns comments posted on reviews

Examples

🚧

Demonstration purposes only. Do not reuse the API passkeys below in your application.

Review examples

Requesting all comments for a particular review

https://stg.api.bazaarvoice.com/data/reviewcomments.json?apiversion=5.4&passkey=kuy3zj9pr3n7i0wxajrzj04xo&filter=reviewid:192548&filter=productId:1000001

This returns comments posted on the specified review.

Requesting a particular review comment

https://stg.api.bazaarvoice.com/data/reviewcomments.json?ApiVersion=5.4&PassKey=kuy3zj9pr3n7i0wxajrzj04xo&Filter=Id:12024&filter=ProductId:1000001

Advanced comment request

https://stg.api.bazaarvoice.com/data/reviewcomments.json?apiversion=5.4&passkey=kuy3zj9pr3n7i0wxajrzj04xo&filter=hasphotos:true&filter=productid:1000001&include=authors,products,categories&sort=totalpositivefeedbackcount:desc&limit=4&offset=4

This request illustrates using multiple filters (just add another &filter=[filter] section), requesting additional content (include=[content]), sorting (sort=[attribute]:[order]), limiting the result count and requesting the second page of results.

Multiple values can be provided in comma-separated form, such as the included content types of authors, reviews, products and categories related to the comments.

Requesting all native (non-syndicated) review comments

🚧

Native (non-syndicated) content only. Continue reading for more details.

https://stg.api.bazaarvoice.com/data/reviewcomments.json?apiversion=5.4&passkey=kuy3zj9pr3n7i0wxajrzj04xo

Requests for this content type that do not include a ProductId, AuthorId, CategoryAncestorId, SubmissionId, or Comment Id filter will only work with API keys that are configured to exclude syndicated content.

We recommend using our Displayable Content Export service to download all of your native and syndicated content. If you still prefer the Conversations API, then you may contact our support team to have your Conversations API keys re-configured.

Parameters

Filter options

• Each filter argument specifies the attribute to filter on followed by a comma-separated list of values. For instance, "Filter=TotalFeedbackCount:eq:3,4" will match all content with TotalFeedbackCount values equal to 3 OR 4.
• Advanced operators can be used to define filters. For instance, "Filter=TotalFeedbackCount:lte:10" will match all content with a rating value less than or equal to 10. All advanced operators are documented on the Conversations API page.
• 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.
• Multiple filters are allowed as URL parameters in which case filters are AND'ed. For instance, "Filter=TotalFeedbackCount:gt:10&Filter=IsFeatured:true" will match all featured content with a TotalFeedbackCount value of greater than 10.
• Time-based filters can be used for SubmissionTime, LastModificationTime and LastModeratedTime. Dates in time-based filters are calculated as the number of seconds since January 1, 1970, 00:00:00 UTC. In a future version, we will be adding support for comparing date/time string values. The following example returns content that was submitted on November 9, 2009: &filter=SubmissionTime:gt:1257746400&filter=SubmissionTime:lt:1257832800

The following table lists the attributes available for filtering.

Sort options

• Sort criteria is specified as :asc for ascending and :desc for descending
• Multi-attribute sorting is supported by using a comma separated list of sort criteria for a content/subject type. For instance Sort=TotalFeedbackCount:desc,TotalPositiveFeedbackCount:asc sorts by number of feedbacks received descending, then number of positive feedbacks received ascending

The following table lists the attributes that are available for sorting.

Response format

Requesting a particular comment

http://[stg.]api.bazaarvoice.com/data/reviewcomments.json?apiversion=5.4&passkey=[yourKey]&filter=id:ProductId&filter:id:[commentId]

{
    "Includes": { },
    "HasErrors": false,
    "Offset": 0,
    "TotalResults": 1,
    "Locale": "en_US",
    "Errors": [ ],
    "Results": [
        {
            "TotalFeedbackCount": 0,
            "TotalPositiveFeedbackCount": 0,
            "ReviewId": "192548",
            "BadgesOrder": [ ],
            "UserLocation": null,
            "Badges": { },
            "AuthorId": "63kfce2dchdd2f8te9en4xx5y",
            "IsSyndicated": null,
            "UserNickname": "tester45454",
            "ProductRecommendationIds": [ ],
            "Title": "TEST>> I came in the store wanting to try 4 other",
            "CommentText": "TEST>> I came in the store wanting to try 4 other dresses, and didnt even notice this one. I walked by a huge poster, and this beautiful dress caught my eye! It ended up being the first dress I tried on, and it was right then, that I knew this was the right dress. After this dress, I tried on 4 other ones, but decided on buying this one. It fits sooooo perfectly, and it gives your body a wonderful shape.test\nI love this dress sooooooo much!!",
            "CampaignId": null,
            "Photos": [ ],
            "TotalNegativeFeedbackCount": 0,
            "SubmissionTime": "2011-06-27T11:44:52.000+00:00",
            "ContentLocale": "en_US",
            "Videos": [ ],
            "ModerationStatus": "APPROVED",
            "SubmissionId": null,
            "Id": "12024",
            "LastModificationTime": "2011-06-30T21:17:17.000+00:00",
            "LastModeratedTime": "2011-06-30T21:17:17.000+00:00"
        }
    ],
    "Limit": 10
}

Response elements

Error codes