{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/tiktokshop/product-reviews.json","title":"tiktokshop/product-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"]},"dropped":{"description":"Optional dropped supplied by this operation. Null means unknown.","type":["number","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"]},"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string","null"]},"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"images":{"description":"Optional images supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"incentivized":{"description":"Optional incentivized supplied by this operation. Null means unknown.","type":["boolean","null"]},"platform":{"description":"Optional platform 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"]},"sku":{"description":"Optional sku supplied by this operation. Null means unknown.","type":["string","null"]},"text":{"description":"Source text when supplied.","type":["string","null"]},"verified_purchase":{"description":"Optional verified purchase 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":["country"],"properties":{"country":{"description":"Optional country supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["created_at"],"properties":{"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string"],"minLength":1}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["images"],"properties":{"images":{"description":"Optional images supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["incentivized"],"properties":{"incentivized":{"description":"Optional incentivized supplied by this operation. Null means unknown.","type":["boolean"]}}},{"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":["sku"],"properties":{"sku":{"description":"Optional sku supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["text"],"properties":{"text":{"description":"Source text when supplied.","type":["string"],"minLength":1}}},{"required":["verified_purchase"],"properties":{"verified_purchase":{"description":"Optional verified purchase supplied by this operation. Null means unknown.","type":["boolean"]}}}]}]}},"review_count":{"description":"Optional review 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,"dropped":0,"has_more":false,"items":[{"author":"example","country":"example","created_at":"2026-09-01T12:00:00Z","id":"example","images":["example"],"incentivized":false,"platform":"example","product_id":"example","rating":0,"sku":"example","text":"example","verified_purchase":false}],"review_count":0}]}