{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/content_analysis/rating-distribution.json","title":"content_analysis/rating-distribution data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"_warnings":{"description":"Optional  warnings supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"distribution":{"description":"Optional distribution supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["number","null"]},"share":{"description":"Optional share supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}},"filters_applied":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"histogram":{"description":"Optional histogram supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true},"keyword":{"description":"Optional keyword supplied by this operation. Null means unknown.","type":["string","null"]},"mean_rating":{"description":"Optional mean rating supplied by this operation. Null means unknown.","type":["number","null"]},"resolved_entity":{"description":"Optional resolved entity supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"developer":{"description":"Optional developer supplied by this operation. Null means unknown.","type":["string","null"]},"exact_name_match":{"description":"Optional exact name match supplied by this operation. Null means unknown.","type":["boolean","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"search_rank":{"description":"Optional search rank supplied by this operation. Null means unknown.","type":["number","null"]},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true},"reviews_sampled":{"description":"Optional reviews sampled supplied by this operation. Null means unknown.","type":["number","null"]},"sources":{"description":"Optional sources supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"endpoint":{"description":"Optional endpoint supplied by this operation. Null means unknown.","type":["string","null"]},"ok":{"description":"Optional ok supplied by this operation. Null means unknown.","type":["boolean","null"]},"returned":{"description":"Optional returned supplied by this operation. Null means unknown.","type":["number","null"]},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}},"sources_unavailable":{"description":"Optional sources unavailable supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"reason":{"description":"Optional reason supplied by this operation. Null means unknown.","type":["string","null"]},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}},"store_reported":{"description":"Optional store reported supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"average_rating":{"description":"Optional average rating supplied by this operation. Null means unknown.","type":["number","null"]},"note":{"description":"Optional note supplied by this operation. Null means unknown.","type":["string","null"]},"rating_count":{"description":"Optional rating count supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"storefront":{"description":"Optional storefront supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["distribution"],"properties":{"distribution":{"description":"Optional distribution supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["number","null"]},"share":{"description":"Optional share supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}}},{"required":["filters_applied"],"properties":{"filters_applied":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["histogram"],"properties":{"histogram":{"description":"Optional histogram supplied by this operation. Null means unknown.","type":["object"],"properties":{},"additionalProperties":true}}},{"required":["mean_rating"],"properties":{"mean_rating":{"description":"Optional mean rating supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["resolved_entity"],"properties":{"resolved_entity":{"description":"Optional resolved entity supplied by this operation. Null means unknown.","type":["object"],"properties":{"developer":{"description":"Optional developer supplied by this operation. Null means unknown.","type":["string","null"]},"exact_name_match":{"description":"Optional exact name match supplied by this operation. Null means unknown.","type":["boolean","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"search_rank":{"description":"Optional search rank supplied by this operation. Null means unknown.","type":["number","null"]},"type":{"description":"Optional type supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}},{"required":["reviews_sampled"],"properties":{"reviews_sampled":{"description":"Optional reviews sampled supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["sources"],"properties":{"sources":{"description":"Optional sources supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"endpoint":{"description":"Optional endpoint supplied by this operation. Null means unknown.","type":["string","null"]},"ok":{"description":"Optional ok supplied by this operation. Null means unknown.","type":["boolean","null"]},"returned":{"description":"Optional returned supplied by this operation. Null means unknown.","type":["number","null"]},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}}},{"required":["sources_unavailable"],"properties":{"sources_unavailable":{"description":"Optional sources unavailable supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"reason":{"description":"Optional reason supplied by this operation. Null means unknown.","type":["string","null"]},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}}},{"required":["store_reported"],"properties":{"store_reported":{"description":"Optional store reported supplied by this operation. Null means unknown.","type":["object"],"properties":{"average_rating":{"description":"Optional average rating supplied by this operation. Null means unknown.","type":["number","null"]},"note":{"description":"Optional note supplied by this operation. Null means unknown.","type":["string","null"]},"rating_count":{"description":"Optional rating count supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["storefront"],"properties":{"storefront":{"description":"Optional storefront supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"_warnings":["example"],"distribution":[{"count":0,"rating":0,"share":0}],"filters_applied":[],"histogram":{},"keyword":"example","mean_rating":0,"resolved_entity":{"developer":"example","exact_name_match":false,"id":"example","name":"example","search_rank":0,"type":"example","url":"https://example.com/example"},"reviews_sampled":0,"sources":[{"endpoint":"example","ok":false,"returned":0,"source":"example"}],"sources_unavailable":[{"reason":"example","source":"example"}],"store_reported":{"average_rating":0,"note":"example","rating_count":0},"storefront":"example"}]}