{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/target/reviews.json","title":"target/reviews data fields","description":"Optional data 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"]},"cursor":{"description":"Opaque next-page token; pass it back unchanged. Null does not prove complete history.","type":["string","null"]},"has_more":{"description":"Source continuation indicator; null means unknown.","type":["boolean","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":{"author":{"description":"Public author information supplied with this record.","type":["string","null"]},"helpful":{"description":"Optional helpful supplied by this operation. Null means unknown.","type":["number","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"incentivized":{"description":"Optional incentivized supplied by this operation. Null means unknown.","type":["boolean","null"]},"photos":{"description":"Optional photos supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"posted_at":{"description":"Optional posted at supplied by this operation. Null means unknown.","type":["string","null"]},"product_id":{"description":"Optional product id supplied by this operation. Null means unknown.","type":["string","null"]},"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["number","null"]},"recommended":{"description":"Optional recommended supplied by this operation. Null means unknown.","type":["boolean","null"]},"responses":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"tags":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"text":{"description":"Source text when supplied.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"unhelpful":{"description":"Optional unhelpful supplied by this operation. Null means unknown.","type":["number","null"]},"verified":{"description":"Optional verified supplied by this operation. Null means unknown.","type":["boolean","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["author"],"properties":{"author":{"description":"Public author information supplied with this record.","type":["string"],"minLength":1}}},{"required":["helpful"],"properties":{"helpful":{"description":"Optional helpful supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["incentivized"],"properties":{"incentivized":{"description":"Optional incentivized supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["photos"],"properties":{"photos":{"description":"Optional photos supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["posted_at"],"properties":{"posted_at":{"description":"Optional posted at supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["product_id"],"properties":{"product_id":{"description":"Optional product id supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["rating"],"properties":{"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["number"]}}},{"required":["recommended"],"properties":{"recommended":{"description":"Optional recommended supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["responses"],"properties":{"responses":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["tags"],"properties":{"tags":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"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":["unhelpful"],"properties":{"unhelpful":{"description":"Optional unhelpful supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["verified"],"properties":{"verified":{"description":"Optional verified supplied by this operation. Null means unknown.","type":["boolean"]}}}]}]}},"page":{"description":"Optional page supplied by this operation. Null means unknown.","type":["number","null"]},"product_id":{"description":"Optional product id supplied by this operation. Null means unknown.","type":["string","null"]},"questions_count":{"description":"Optional questions count supplied by this operation. Null means unknown.","type":["number","null"]},"rating":{"description":"Source rating; read its accompanying scale and vote count.","type":["object","null"],"properties":{"max":{"description":"Optional max supplied by this operation. Null means unknown.","type":["number","null"]},"value":{"description":"Optional value supplied by this operation. Null means unknown.","type":["number","null"]},"votes":{"description":"Optional votes supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"rating_distribution":{"description":"Optional rating distribution supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true},"recommended_percentage":{"description":"Optional recommended percentage supplied by this operation. Null means unknown.","type":["number","null"]},"total":{"description":"Source-reported total; null is unknown.","type":["number","null"]},"total_pages":{"description":"Optional total pages supplied by this operation. Null means unknown.","type":["number","null"]},"with_photos_count":{"description":"Optional with photos count supplied by this operation. Null means unknown.","type":["number","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":[{"count":0,"cursor":null,"has_more":false,"items":[{"author":"example","helpful":0,"id":"example","incentivized":false,"photos":["example"],"platform":"example","posted_at":"2026-09-01T12:00:00Z","product_id":"example","rating":0,"recommended":false,"responses":[],"tags":[],"text":"example","title":"example","unhelpful":0,"verified":false}],"page":0,"product_id":"example","questions_count":0,"rating":{"max":0,"value":0,"votes":0},"rating_distribution":{},"recommended_percentage":0,"total":0,"total_pages":0,"with_photos_count":0}]}