Docs · methods

Reviews

Customer reviews collected for one competitor at a time, across G2, Capterra, Trustpilot and any custom sources, each review with its url and publish date.

get_reviews

01

Get competitor reviews

get_reviewsread

The reviews collected for one competitor, newest first. competitorId is required: reviews are read one competitor at a time. Only tracked competitors are covered; list_competitors shows which are tracked.

Parameters7

  • projectIdintegerRequiredProject id from list_projects. Every scoped method needs it.
  • competitorIdintegerRequiredCompetitor id from list_competitors. Reviews are read one competitor at a time.
  • minRatingintegerOptionalKeep only reviews rated at or above this, on the 1-5 scale.
  • fromISO dateOptionalOnly items published on or after this date, e.g. 2026-08-01.
  • toISO dateOptionalOnly items published on or before this date.
  • limitintegerOptionalRows to return. Defaults to 20, clamped to 100.
  • cursorstringOptionalnextCursor from the previous page of this same method.

Returns5

  • projectNamestring
  • competitorNamestring
  • items[]reviewsource, title, text, rating (1-5, normalized), reviewerRole, sourceUrl, publishedAt. Reviewer names are never returned.
  • nextCursorstring | nullPass back as cursor to read the next page. Null when done.
  • hasMoreboolean
← NewsWebsite changes →