Schema.org Review

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://schema.org/schemas/review.json",
  "title": "Schema.org Review",
  "description": "A review of an item, such as a product, service, or creative work.",
  "type": "object",
  "required": ["@type"],
  "properties": {
    "@type": {
      "type": "string",
      "description": "The Schema.org type.",
      "enum": ["Review", "ClaimReview", "CriticReview", "EmployerReview", "MediaReview", "Recommendation", "UserReview"]
    },
    "@context": {
      "type": "string",
      "default": "https://schema.org"
    },
    "name": {
      "type": "string",
      "description": "The name of the review."
    },
    "description": {
      "type": "string",
      "description": "A description of the review."
    },
    "reviewBody": {
      "type": "string",
      "description": "The actual body of the review."
    },
    "reviewRating": {
      "$ref": "#/$defs/Rating",
      "description": "The rating given in this review."
    },
    "author": {
      "oneOf": [
        { "$ref": "schema-org-person-schema.json" },
        { "$ref": "schema-org-organization-schema.json" }
      ],
      "description": "The author of this review."
    },
    "publisher": {
      "$ref": "schema-org-organization-schema.json",
      "description": "The publisher of this review."
    },
    "datePublished": {
      "type": "string",
      "format": "date",
      "description": "Date of first publication."
    },
    "dateModified": {
      "type": "string",
      "format": "date",
      "description": "The date the review was most recently modified."
    },
    "itemReviewed": {
      "type": "object",
      "description": "The item that is being reviewed.",
      "properties": {
        "@type": { "type": "string" },
        "name": { "type": "string" },
        "url": { "type": "string", "format": "uri" }
      }
    },
    "positiveNotes": {
      "type": "object",
      "description": "Positive aspects of the reviewed item.",
      "properties": {
        "@type": { "const": "ItemList" },
        "itemListElement": { "type": "array", "items": { "type": "object", "properties": { "@type": { "const": "ListItem" }, "name": { "type": "string" } } } }
      }
    },
    "negativeNotes": {
      "type": "object",
      "description": "Negative aspects of the reviewed item.",
      "properties": {
        "@type": { "const": "ItemList" },
        "itemListElement": { "type": "array", "items": { "type": "object", "properties": { "@type": { "const": "ListItem" }, "name": { "type": "string" } } } }
      }
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "URL of the review."
    },
    "sameAs": {
      "oneOf": [
        { "type": "string", "format": "uri" },
        { "type": "array", "items": { "type": "string", "format": "uri" } }
      ],
      "description": "URL of a reference Web page that unambiguously indicates the item's identity."
    }
  },
  "$defs": {
    "Rating": {
      "type": "object",
      "description": "A rating is an evaluation on a numeric scale.",
      "properties": {
        "@type": { "type": "string", "const": "Rating" },
        "ratingValue": { "oneOf": [{ "type": "number" }, { "type": "string" }], "description": "The rating for the content." },
        "bestRating": { "oneOf": [{ "type": "number" }, { "type": "string" }], "description": "The highest value allowed in this rating system." },
        "worstRating": { "oneOf": [{ "type": "number" }, { "type": "string" }], "description": "The lowest value allowed in this rating system." },
        "ratingExplanation": { "type": "string", "description": "A short explanation for the rating." }
      }
    }
  }
}