Publishing Reviews via the Public API

Written By Chad McGuire (Sparrow Intel)

Every review in Sparrow Intel has a published field β€” a simple true/false flag that you control.

It doesn't change anything in Sparrow Intel itself. It exists so that, when you query reviews through the public API, you can filter for published: true and only surface the reviews you've approved for your own site, widget, or downstream system.

Setting the field manually

On any review, use the Publish / Unpublish button in the action bar to toggle the field on or off.

Setting the field automatically

To publish reviews in bulk based on criteria you define, create a Review rule with the Set Published Field action. Combine it with any conditions you'd normally use (e.g. overall rating is 5, sentiment is positive, OTA is Airbnb) and matching reviews will be marked as published automatically going forward.

Typical workflow

  1. Decide what "publishable" means for your site (e.g. 4β˜… or higher, no policy violations, English only).
  2. Create a Review rule with those conditions and a Set Published Field action.
  3. In your public API query, filter on published: true to feed only those reviews to your direct booking site or other downstream system.