Reviews

List Reviews

get

Retrieve project reviews with facet, source, location, score, and tag filters, optional sorting by rating or timestamps, and calendar bounds on a chosen review datetime column.

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

date_fromstring · date · nullableOptional

Inclusive lower calendar date (YYYY-MM-DD) for the column chosen by date_key, defaulting to created_at when date_key is omitted.

date_keystring · enum · nullableOptional

Review datetime column paired with date_from and date_to (defaults to created_at when omitted).

Possible values:

date_tostring · date · nullableOptional

Inclusive upper calendar date (YYYY-MM-DD) for the column chosen by date_key; must be on or after date_from when both bounds are provided.

filterstring · enum · nullableOptional

Review list facet aligned with console filters (non-duplicates unless duplicate is selected).

Possible values:

limitinteger · nullableOptional

Maximum number of records to return.

location_idinteger · nullableOptional

Unique numeric identifier for the location.

location_slugstring · nullableOptional

URL-friendly identifier for the location.

location_uuidstring · nullableOptional

Stable UUID for the location.

scoreinteger · min: 1 · max: 5 · nullableOptional

Numeric rating score for the review.

source_idinteger · nullableOptional

Identifier for the source system or review platform.

source_slugstring · nullableOptional

Source slug for this resource.

source_uuidstring · nullableOptional

Source uuid for this resource.

sort_dirstring · enum · nullableOptional

Sort direction applied when sort_key is set (defaults to desc when omitted).

Possible values:

sort_keystring · enum · nullableOptional

Review attribute to sort by; omit to use newest-first by creation time.

Possible values:

tag_slugstring · nullableOptional

URL-friendly identifier for the review tag.

Responses

200

Success

application/json

Object containing response data for this resource.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Short code or application-level status code for this resource.

get

/reviews

HTTPcURLJavaScriptPython

GET /project/reviews HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "code": 200,
  "data": [
    {
      "id": 77,
      "uuid": "c2928ac9-8c0a-4e8a-b3b0-6dbd12d4d1ce",
      "score": 5,
      "review": "The staff was friendly and the appointment started right on time.",
      "review_html": "<p>The staff was friendly and the appointment started right on time.</p>",
      "reply": "Thank you for sharing your experience, Alex!",
      "is_hidden": false,
      "is_duplicate": false,
      "has_highlights": true,
      "can_reply": true,
      "has_reply": true,
      "external_url": "https://www.google.com/maps/reviews/acme-dental-77",
      "platform_url": "https://app.moregoodreviews.com/projects/42/reviews/77",
      "replied_at": 1714680000,
      "created_at": 1714593600,
      "customer": {
        "id": 101,
        "uuid": "c53958ca-dfa3-4804-b711-0b7e61e7d8de",
        "name": "Alex Johnson",
        "color": "#4F46E5",
        "platform_url": "https://app.moregoodreviews.com/projects/42/customers/101"
      },
      "location": {
        "id": 12,
        "project_id": 42,
        "uuid": "51987517-6a48-4e4d-87d5-934147e46234",
        "name": "Downtown",
        "display_name": "Acme Dental Downtown",
        "slug": "downtown",
        "store_code": "CHI-DTN",
        "title": "Downtown Office",
        "address": "123 Main St, Chicago, IL 60601",
        "address1": "123 Main St",
        "address2": "Suite 400",
        "city": "Chicago",
        "state": "IL",
        "postal_code": "60601"
      },
      "rating": {
        "id": 5,
        "score": 5,
        "label": "Excellent"
      },
      "reviewer": {
        "id": 14,
        "name": "Alex Johnson",
        "photo_url": "https://lh3.googleusercontent.com/a-/alex"
      },
      "source": {
        "id": 5,
        "uuid": "59fd6c84-2955-4ef7-a665-48a87b79f35b",
        "name": "Google",
        "slug": "google",
        "sprite": "fab fa-google",
        "color": "#DB4437",
        "icon": null
      },
      "fields": [
        {
          "name": "service",
          "value": "Cleaning"
        }
      ],
      "tags": [
        {
          "id": 9,
          "uuid": "719c34f3-30fd-4d9e-82dd-172ce6d554af",
          "name": "VIP",
          "slug": "vip"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://api.moregoodreviews.com/project/reviews",
    "per_page": 50,
    "to": 1,
    "total": 1
  }
}

Delete Review

delete

Remove a review that should no longer be reconciled.

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Unique numeric identifier for this resource.

Responses

200

Success

application/json

Object containing response data for this resource.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Short code or application-level status code for this resource.

delete

/reviews/{id}

HTTPcURLJavaScriptPython

DELETE /project/reviews/{id} HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "success": true,
  "code": 200
}

Update Review Visibility

put

Show or hide a review in public displays.

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Unique numeric identifier for this review.

Body

application/json

Request body containing the desired review visibility flag.

is_hiddenbooleanRequired

Whether this review should be hidden from public displays.

Responses

200

Success

application/json

Object containing response status for the request.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Application-level status code returned by More Good Reviews.

put

/reviews/{id}/flag-hidden

HTTPcURLJavaScriptPython

PUT /project/reviews/{id}/flag-hidden HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "is_hidden": true
}

200

Success

{
  "success": true,
  "code": 200
}

Update Review Duplicate Flag

put

Mark whether a review is a duplicate record.

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Unique numeric identifier for this review.

Body

application/json

Request body containing the desired duplicate flag.

is_duplicatebooleanRequired

Whether this review should be marked as a duplicate.

Responses

200

Success

application/json

Object containing response status for the request.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Application-level status code returned by More Good Reviews.

put

/reviews/{id}/flag-duplicate

HTTPcURLJavaScriptPython

PUT /project/reviews/{id}/flag-duplicate HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "is_duplicate": true
}

200

Success

{
  "success": true,
  "code": 200
}

Update Review Tags

put

Replace the tag assignments for a review using the provided slug list.

Authorizations

ApiKey

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Unique numeric identifier for the review.

Body

application/json

Request body listing tag slugs to apply; omitting unrelated tags removes them from the review.

tag_slugsstring[]Required

Tag slugs to assign; send an empty array to clear all tags from this review.

Responses

200

Success

application/json

Object containing response status for the request.

successbooleanOptional

Indicates whether the request completed successfully.

codeintegerOptional

Application-level status code returned by More Good Reviews.

put

/reviews/{id}/tags

HTTPcURLJavaScriptPython

PUT /project/reviews/{id}/tags HTTP/1.1
Host: api.moregoodreviews.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "tag_slugs": [
    "great-service",
    "five-star"
  ]
}

200

Success

{
  "success": true,
  "code": 200
}