{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/app_store/app-reviews.json","title":"app_store/app-reviews 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"]}},"app_id":{"description":"Optional app id supplied by this operation. Null means unknown.","type":["string","null"]},"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string","null"]},"cursor":{"description":"Opaque next-page token; pass it back unchanged. Null does not prove complete history.","type":["string","null"]},"items":{"description":"Returned records. Source coverage and completeness vary.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":"object","properties":{"app_version":{"description":"Optional app version supplied by this operation. Null means unknown.","type":["string","null"]},"author":{"description":"Public author information supplied with this record.","type":["object","null"],"properties":{"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["number","null"]},"text":{"description":"Source text when supplied.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"updated_at":{"description":"Optional updated at supplied by this operation. Null means unknown.","type":["string","null"]},"votes":{"description":"Optional votes 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"]},"sum":{"description":"Optional sum supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["app_version"],"properties":{"app_version":{"description":"Optional app version supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["author"],"properties":{"author":{"description":"Public author information supplied with this record.","type":["object"],"properties":{"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["rating"],"properties":{"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["number"]}}},{"required":["text"],"properties":{"text":{"description":"Source text when supplied.","type":["string"],"minLength":1}}},{"required":["title"],"properties":{"title":{"description":"Source title when supplied.","type":["string"],"minLength":1}}},{"required":["updated_at"],"properties":{"updated_at":{"description":"Optional updated at supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["votes"],"properties":{"votes":{"description":"Optional votes supplied by this operation. Null means unknown.","type":["object"],"properties":{"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"sum":{"description":"Optional sum supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}}]}]}},"sort_by":{"description":"Optional sort by supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true,"required":["items"],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"_warnings":["example"],"app_id":"example","count":0,"country":"example","cursor":null,"items":[{"app_version":"example","author":{"name":"example","url":"https://example.com/example"},"id":"example","rating":0,"text":"example","title":"example","updated_at":"2026-09-01T12:00:00Z","votes":{"count":0,"sum":0}}],"sort_by":"example"}]}