Reviews

Reviews are the Google (and other platform) reviews collected for your account. You can list and filter reviews, retrieve individual reviews with full detail, and manage replies.

The review model

Properties

Name
id
Type
string
Description
Unique identifier for the review.
Name
rating
Type
integer
Description
Star rating from 1 to 5.
Name
comment
Type
string
Description
The reviewer's written comment, if any.
Name
external_id
Type
string
Description
The review's ID on the originating platform (e.g. Google).
Name
reviewer_name
Type
string
Description
Name of the contact who left the review.
Name
contact_id
Type
string
Description
ID of the associated contact.
Name
has_reply
Type
boolean
Description
Whether a reply has been posted for this review.
Name
created_at
Type
timestamp
Description
Timestamp of when the review was recorded.
Name
updated_at
Type
timestamp
Description
Timestamp of when the review was last updated.

GET/v1/reviews

List all reviews

Returns a paginated list of reviews, ordered by most recently created.

Optional attributes

Name
rating
Type
integer
Description
Filter by star rating (1–5).
Name
reply_status
Type
string
Description
Filter by reply status. One of replied or awaiting_reply.
Name
limit
Type
integer
Description
Number of reviews to return per page (1–100). Defaults to 25.
Name
page
Type
integer
Description
Page number. Defaults to 1.

Request

GET

/v1/reviews

curl -G https://dashboard.reviewrover.co/api/v1/reviews \
  -H "Authorization: Bearer {token}" \
  -d rating=5 \
  -d reply_status=awaiting_reply

Response

{
  "reviews": [
    {
      "id": "rev_Kd93lftgZXGRbxqoj",
      "rating": 5,
      "comment": "Absolutely fantastic service!",
      "reviewer_name": "Frank McCallister",
      "contact_id": "cont_KYdl3lftgZXGRbxqoj",
      "has_reply": false,
      "created_at": "2025-02-17T02:00:34Z",
      "updated_at": "2025-02-17T02:00:34Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 1,
    "total_pages": 1
  }
}

GET/v1/reviews/:id

Retrieve a review

Retrieves a review by ID. The detailed response includes the full reply and contact objects.

Request

GET

/v1/reviews/rev_Kd93lftgZXGRbxqoj

curl https://dashboard.reviewrover.co/api/v1/reviews/rev_Kd93lftgZXGRbxqoj \
  -H "Authorization: Bearer {token}"

Response

{
  "id": "rev_Kd93lftgZXGRbxqoj",
  "rating": 5,
  "comment": "Absolutely fantastic service!",
  "reviewer_name": "Frank McCallister",
  "contact_id": "cont_KYdl3lftgZXGRbxqoj",
  "has_reply": true,
  "review_reply": {
    "id": 1,
    "comment": "Thank you so much, Frank!",
    "replied_at": "2025-02-18T09:00:00Z",
    "created_at": "2025-02-18T09:00:00Z"
  },
  "contact": {
    "id": "cont_KYdl3lftgZXGRbxqoj",
    "name": "Frank McCallister",
    "email": "[email protected]",
    "phone": "1-800-759-3000"
  },
  "created_at": "2025-02-17T02:00:34Z",
  "updated_at": "2025-02-17T02:00:34Z"
}

Review Replies

The review reply model

Name
id
Type
integer
Description
Unique identifier for the reply.
Name
review_id
Type
string
Description
ID of the review this reply belongs to.
Name
comment
Type
string
Description
The reply text.
Name
replied_at
Type
timestamp
Description
When the reply was posted on the review platform.
Name
created_at
Type
timestamp
Description
Timestamp of when the reply was created.
Name
updated_at
Type
timestamp
Description
Timestamp of when the reply was last updated.

POST/v1/reviews/:review_id/reply/generate

Generate a reply

Uses AI to draft a reply to the review. Returns the suggested text without saving it.

Optional attributes

Name
tone
Type
string
Description
Tone of the generated reply. One of casual, professional, or friendly. Defaults to casual.

Request

POST

/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply/generate

curl -X POST https://dashboard.reviewrover.co/api/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply/generate \
  -H "Authorization: Bearer {token}" \
  -d tone="professional"

Response

{
  "reply": "Thank you for your kind words, Frank! We truly appreciate your support.",
  "tone": "professional"
}

GET/v1/reviews/:review_id/reply

Get reply

Retrieves the existing reply for a review.

Request

GET

/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply

curl https://dashboard.reviewrover.co/api/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply \
  -H "Authorization: Bearer {token}"

Response

{
  "id": 1,
  "review_id": "rev_Kd93lftgZXGRbxqoj",
  "comment": "Thank you so much, Frank!",
  "replied_at": "2025-02-18T09:00:00Z",
  "created_at": "2025-02-18T09:00:00Z",
  "updated_at": "2025-02-18T09:00:00Z"
}

POST/v1/reviews/:review_id/reply

Create a reply

Required attributes

Name
comment
Type
string
Description
The reply text.

Optional attributes

Name
replied_at
Type
timestamp
Description
When the reply was posted externally. Defaults to now.

Request

POST

/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply

curl -X POST https://dashboard.reviewrover.co/api/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply \
  -H "Authorization: Bearer {token}" \
  -d comment="Thank you so much, Frank!"

Response

{
  "id": 1,
  "review_id": "rev_Kd93lftgZXGRbxqoj",
  "comment": "Thank you so much, Frank!",
  "replied_at": "2025-02-18T09:00:00Z",
  "created_at": "2025-02-18T09:00:00Z",
  "updated_at": "2025-02-18T09:00:00Z"
}

PUT/v1/reviews/:review_id/reply

Update a reply

Optional attributes

Name
comment
Type
string
Description
Updated reply text.
Name
replied_at
Type
timestamp
Description
Updated replied_at timestamp.

Request

PUT

/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply

curl -X PUT https://dashboard.reviewrover.co/api/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply \
  -H "Authorization: Bearer {token}" \
  -d comment="Updated reply text."

DELETE/v1/reviews/:review_id/reply

Delete a reply

Permanently deletes the reply for a review.

Request

DELETE

/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply

curl -X DELETE https://dashboard.reviewrover.co/api/v1/reviews/rev_Kd93lftgZXGRbxqoj/reply \
  -H "Authorization: Bearer {token}"