Schema.org · Schema
Schema.org AggregateRating
The average rating based on multiple ratings or reviews.
Schema.orgStructured DataLinked DataJSON-LDVocabularySEOWeb StandardsRDFOntology
Properties
| Name | Type | Description |
|---|---|---|
| @type | string | The Schema.org type. |
| @context | string | |
| ratingValue | object | The rating for the content. |
| bestRating | object | The highest value allowed in this rating system. |
| worstRating | object | The lowest value allowed in this rating system. |
| ratingCount | integer | The count of total number of ratings. |
| reviewCount | integer | The count of total number of reviews. |
| itemReviewed | object | The item that is being rated. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://schema.org/schemas/aggregate-rating.json",
"title": "Schema.org AggregateRating",
"description": "The average rating based on multiple ratings or reviews.",
"type": "object",
"required": ["@type", "ratingValue"],
"properties": {
"@type": {
"type": "string",
"const": "AggregateRating",
"description": "The Schema.org type."
},
"@context": {
"type": "string",
"default": "https://schema.org"
},
"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."
},
"ratingCount": {
"type": "integer",
"description": "The count of total number of ratings."
},
"reviewCount": {
"type": "integer",
"description": "The count of total number of reviews."
},
"itemReviewed": {
"type": "object",
"description": "The item that is being rated.",
"properties": {
"@type": { "type": "string" },
"name": { "type": "string" }
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/schema-org-aggregate-rating"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.