{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/tiktok/playlist-videos.json","title":"tiktok/playlist-videos 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"]},"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":["object","null"],"properties":{"avatar_url":{"description":"Optional avatar url supplied by this operation. Null means unknown.","type":["string","null"]},"handle":{"description":"Optional handle supplied by this operation. Null means unknown.","type":["string","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"]}},"additionalProperties":true},"caption":{"description":"Optional caption supplied by this operation. Null means unknown.","type":["string","null"]},"cover":{"description":"Optional cover supplied by this operation. Null means unknown.","type":["string","null"]},"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string","null"]},"duration_s":{"description":"Optional duration s supplied by this operation. Null means unknown.","type":["number","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"images":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"is_ad":{"description":"Optional is ad supplied by this operation. Null means unknown.","type":["boolean","null"]},"is_pinned":{"description":"Optional is pinned supplied by this operation. Null means unknown.","type":["boolean","null"]},"media_urls":{"description":"Optional media urls supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"music":{"description":"Optional music supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"play_url":{"description":"Optional play url supplied by this operation. Null means unknown.","type":["string","null"]},"region":{"description":"Optional region supplied by this operation. Null means unknown.","type":["string","null"]},"stats":{"description":"Optional stats supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"comments":{"description":"Optional comments supplied by this operation. Null means unknown.","type":["number","null"]},"downloads":{"description":"Optional downloads supplied by this operation. Null means unknown.","type":["number","null"]},"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number","null"]},"plays":{"description":"Optional plays supplied by this operation. Null means unknown.","type":["number","null"]},"saves":{"description":"Optional saves supplied by this operation. Null means unknown.","type":["number","null"]},"shares":{"description":"Optional shares supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"video_url":{"description":"Optional video url supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["author"],"properties":{"author":{"description":"Public author information supplied with this record.","type":["object"],"properties":{"avatar_url":{"description":"Optional avatar url supplied by this operation. Null means unknown.","type":["string","null"]},"handle":{"description":"Optional handle supplied by this operation. Null means unknown.","type":["string","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"]}},"additionalProperties":true}}},{"required":["caption"],"properties":{"caption":{"description":"Optional caption supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["cover"],"properties":{"cover":{"description":"Optional cover 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":["duration_s"],"properties":{"duration_s":{"description":"Optional duration s 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":["images"],"properties":{"images":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["is_ad"],"properties":{"is_ad":{"description":"Optional is ad supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["is_pinned"],"properties":{"is_pinned":{"description":"Optional is pinned supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["media_urls"],"properties":{"media_urls":{"description":"Optional media urls supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["music"],"properties":{"music":{"description":"Optional music supplied by this operation. Null means unknown.","type":["object"],"properties":{},"additionalProperties":true}}},{"required":["play_url"],"properties":{"play_url":{"description":"Optional play url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["region"],"properties":{"region":{"description":"Optional region supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["stats"],"properties":{"stats":{"description":"Optional stats supplied by this operation. Null means unknown.","type":["object"],"properties":{"comments":{"description":"Optional comments supplied by this operation. Null means unknown.","type":["number","null"]},"downloads":{"description":"Optional downloads supplied by this operation. Null means unknown.","type":["number","null"]},"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number","null"]},"plays":{"description":"Optional plays supplied by this operation. Null means unknown.","type":["number","null"]},"saves":{"description":"Optional saves supplied by this operation. Null means unknown.","type":["number","null"]},"shares":{"description":"Optional shares supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["thumbnail_url"],"properties":{"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}},{"required":["video_url"],"properties":{"video_url":{"description":"Optional video url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}}]}]}},"playlist_id":{"description":"Optional playlist id 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":[{"count":0,"dropped":0,"has_more":false,"items":[{"author":{"avatar_url":"https://example.com/example","handle":"example","id":"example","name":"example"},"caption":"example","cover":"example","created_at":"2026-09-01T12:00:00Z","duration_s":0,"id":"example","images":[],"is_ad":false,"is_pinned":false,"media_urls":["example"],"music":{},"platform":"example","play_url":"https://example.com/example","region":"example","stats":{"comments":0,"downloads":0,"likes":0,"plays":0,"saves":0,"shares":0},"thumbnail_url":"https://example.com/example","url":"https://example.com/example","video_url":"https://example.com/example"}],"playlist_id":"example"}]}