Available Tools
Identifying a Review
Most review tools need two values together, because a review id is only unique within its type:reviewType: one oftext,video,audio, orsocialreviewId: the id returned byget_reviews,filter_reviews, orget_review
batch_update_reviews takes a list of these pairs, so you can mix review types in a single call.
Widgets and Wall of Love pages use a different identifier:
feed_identifier, a single string that looks like feed-video-item-428. Use that when passing reviews to create_widget, update_widget, create_page, or update_page.Filtering Notes
filter_reviewsacceptsreviewTypes(video,audio,text,social),starRatings(1 to 5),sentiment(positive,neutral,negative),formIds,reviewLabelIds,importedSourceIds, and asearchkeyword.- Handy boolean filters:
favourite,reviewWithComment, andhasCompanyLogo(useful when picking reviews for a Company Logo Slider widget). perPageis capped at 100, but the backend currently returns a fixed page size of 15 and may ignore the value.get_review_summaryreturns only a total count. For per-type or per-rating numbers, usefilter_reviewsand read the pagination total.
Ratings on social reviews (including most imported ones) cannot be changed through
update_review, matching the behaviour of the web app. Reviewer fields that the original form did not capture are quietly skipped.