1. Reviews
TrustWILL
  • Reviews Widget Integration
  • Reviews Data API
    • Trustoo Open API — Quick Start
    • OAuth2
      • OAuth2 Merchant Authorization
      • Get OAuth2 Authorization URL
      • OAuth2 Get / Refresh Access Token
      • Revoke Token
    • Platform Management
      • Disconnect Platform Authorization
      • Get Shop Authorization Info
      • Get Shop Installation Status
      • Cancel Platform Authorization
    • Webhooks
      • Create Shop Webhook
      • Update Shop Webhook
      • Delete Shop Webhook
      • Get Shop Webhooks
    • Reviews
      • Get Review Detail
        GET
      • Get Review List
        GET
      • Create Review
        POST
      • Delete Review
        POST
      • Get Rating
        GET
    • Media Upload
      • Get Video Upload URL
      • Get Image Upload Credentials
    • Orders
      • Get Order List
    • Customer Events
      • Get Customer Event List
    • Customers
      • Email Unsubscribe
      • Create Customer Exclusion
      • Delete Customer Exclusion
      • Get Customer Exclusion List
  • Schemas
    • SuccessResponse
    • ErrorResponse
    • Pagination
    • OAuthTokenRequest
    • Webhook
    • CreateReviewRequest
    • Review
    • Rating
    • Order
    • CustomerEvent
    • CustomerExclusion
    • ImageUploadCredentials
  1. Reviews

Get Review List

GET
/api/v1/openapi/get_reviews
Query reviews with filtering, sorting, and pagination.
Authentication: HMAC signature OR OAuth2 Bearer Token
Scope: read_reviews

Request

Authorization
API Key
Add parameter in header
Public-Token
Example:
Public-Token: ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://rapi.trustoo.io/api/v1/openapi/get_reviews?review_ids=undefined&product_ids=undefined&is_store_review=undefined&keyword=undefined&ratings=undefined&sources=undefined&media_types=undefined&sort_by=undefined&page_size=20&page=1' \
--header 'Sign;' \
--header 'Timestamp;' \
--header 'Public-Token: <api-key>'

Responses

🟢200
application/json
Paginated review list
Bodyapplication/json

Example
{
    "code": 0,
    "message": "string",
    "time": 0,
    "request_id": "string",
    "data": {
        "page": {
            "page": 0,
            "page_size": 0,
            "total_page": 0,
            "count": 0
        },
        "list": [
            {
                "id": "string",
                "rating": 0,
                "author": "string",
                "author_email": "string",
                "author_phone": "string",
                "author_country": "string",
                "title": "string",
                "content": "string",
                "commented_at": "string",
                "item_type": "string",
                "order_id": "string",
                "variant_id": "string",
                "source": "string",
                "is_verified": 0,
                "is_featured": 0,
                "is_published": 0,
                "is_top": 0,
                "tag": "string",
                "media_type": 0,
                "media": [
                    {
                        "url": "string",
                        "thumbnail_url": "string",
                        "type": 0,
                        "is_published": 0
                    }
                ],
                "reply": {
                    "id": "string",
                    "content": "string",
                    "reply_at": "string"
                },
                "product": {
                    "id": "string",
                    "title": "string",
                    "handle": "string",
                    "image_src": "string",
                    "url": "string"
                },
                "created_at": "string",
                "updated_at": "string"
            }
        ]
    }
}
Modified at 2026-06-24 04:25:21
Previous
Get Review Detail
Next
Create Review
Built with