Reviews

Fetching reviews

You can fetch website reviews from your connected platforms and internal Rating Captain platform.

get/api/v2/simple_rates

Request

  • Base URL: https://api.ratingcaptain.com
  • URL: https://api.ratingcaptain.com/api/v2/simple_rates
  • Auth: API key in header api-token

Headers

api-tokenstring
website-tokenstring

Request body

pagenumber nullable

Must be at least 1.

per_pagenumber nullable

Must be at least 1. Must not be greater than 100.

after_datestring nullable

Must be a valid date in the format <code>Y-m-d</code>.

before_datestring nullable

Must be a valid date in the format <code>Y-m-d</code>.

rvs_typesstring[]

left_rv_to_rc_neg_captured - This filter displays reviews after negative reactions that were intercepted by RatingCaptain and not published on an external platform.<br> left_rv_to_rc_pos_without_ptm_pos - This filter displays invitations with positive reactions without a review on an external platform.<br> left_rv_to_ptm_pos - This filter displays invitations with positive reactions and a review on an external platform. <br> left_rv_to_ptm_neg - This filter displays invitations with negative reactions and a review on an external platform.<br> organic_to_ptm_pos - This filter displays positive reviews on an external platform without a match to any invitation.<br> organic_to_ptm_neg - This filter displays negative reviews on an external platform without a match to any invitation.<br>.

rv_stars_fromnumber nullable

Must be at least 1. Must not be greater than 5.

rv_stars_tonumber nullable

Must not be greater than 5. Must be at least 1.

rv_text_len_fromnumber nullable
rv_text_len_tonumber nullable
rv_text_contains_phrasestring nullable

Must not be greater than 191 characters.

order_by'date' | 'stars' nullable
order_type'asc' | 'desc' nullable

Example request

{
  "page": 29,
  "per_page": 16,
  "after_date": "2026-10-13",
  "before_date": "2026-10-13",
  "rvs_types": [
    "left_rv_to_ptm_pos"
  ],
  "rv_stars_from": 5,
  "rv_stars_to": 85,
  "rv_text_len_from": 0.5,
  "rv_text_len_to": 40,
  "rv_text_contains_phrase": "xldrgqivqgn",
  "order_by": "stars",
  "order_type": "desc"
}

Changes

No recorded changes to this operation across all 1 revision of this API.