Trustpilot · JSON Structure

Trustpilot Review Structure

Structure documentation for Trustpilot review objects.

Type: Properties: 0
Consumer ReviewsReviewsTrustRatingsBusiness ProfilesProduct Reviews

Trustpilot Review is a JSON Structure definition published by Trustpilot.

Meta-schema:

JSON Structure

Raw ↑
{
  "name": "Trustpilot Review",
  "description": "Structure documentation for Trustpilot review objects.",
  "fields": [
    {"name": "id", "type": "string", "required": true, "description": "Unique review identifier."},
    {"name": "stars", "type": "integer", "required": true, "min": 1, "max": 5, "description": "Star rating (1-5)."},
    {"name": "title", "type": "string", "required": false, "description": "Review title."},
    {"name": "text", "type": "string", "required": false, "description": "Review body text."},
    {"name": "language", "type": "string", "required": false, "description": "ISO 639-1 language code."},
    {"name": "createdAt", "type": "date-time", "required": true, "description": "Review creation timestamp."},
    {"name": "updatedAt", "type": "date-time", "required": false, "description": "Last update timestamp."},
    {"name": "consumer.id", "type": "string", "required": true, "description": "Consumer identifier."},
    {"name": "consumer.displayName", "type": "string", "required": true, "description": "Consumer display name."},
    {"name": "consumer.email", "type": "string", "required": false, "description": "Consumer email (private only)."},
    {"name": "businessUnit.id", "type": "string", "required": true, "description": "Business unit identifier."},
    {"name": "status", "type": "string", "required": true, "enum": ["active", "archived"], "description": "Review status."},
    {"name": "verificationLevel", "type": "string", "required": false, "description": "Verification level."},
    {"name": "orderId", "type": "string", "required": false, "description": "Order reference (private only)."},
    {"name": "reply.message", "type": "string", "required": false, "description": "Company reply text."}
  ]
}