{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/tiktok/search-music.json","title":"tiktok/search-music 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":{"album":{"description":"Optional album supplied by this operation. Null means unknown.","type":["string","null"]},"artists":{"description":"Optional artists supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"author":{"description":"Public author information supplied with this record.","type":["string","null"]},"commercial":{"description":"Optional commercial supplied by this operation. Null means unknown.","type":["boolean","null"]},"cover":{"description":"Optional cover supplied by this operation. Null means unknown.","type":["string","null"]},"duration_seconds":{"description":"Optional duration seconds supplied by this operation. Null means unknown.","type":["number","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"is_original":{"description":"Optional is original supplied by this operation. Null means unknown.","type":["boolean","null"]},"owner_handle":{"description":"Optional owner handle supplied by this operation. Null means unknown.","type":["string","null"]},"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"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"video_count":{"description":"Optional video count supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["album"],"properties":{"album":{"description":"Optional album supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["artists"],"properties":{"artists":{"description":"Optional artists supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["author"],"properties":{"author":{"description":"Public author information supplied with this record.","type":["string"],"minLength":1}}},{"required":["commercial"],"properties":{"commercial":{"description":"Optional commercial supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["cover"],"properties":{"cover":{"description":"Optional cover supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["duration_seconds"],"properties":{"duration_seconds":{"description":"Optional duration seconds 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":["is_original"],"properties":{"is_original":{"description":"Optional is original supplied by this operation. Null means unknown.","type":["boolean"]}}},{"required":["owner_handle"],"properties":{"owner_handle":{"description":"Optional owner handle supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["play_url"],"properties":{"play_url":{"description":"Optional play url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["title"],"properties":{"title":{"description":"Source title when supplied.","type":["string"],"minLength":1}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}},{"required":["video_count"],"properties":{"video_count":{"description":"Optional video count supplied by this operation. Null means unknown.","type":["number"]}}}]}]}},"query":{"description":"Optional query supplied by this operation. Null means unknown.","type":["string","null"]},"region":{"description":"Optional region 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,"cursor":null,"dropped":0,"has_more":false,"items":[{"album":"example","artists":["example"],"author":"example","commercial":false,"cover":"example","duration_seconds":0,"id":"example","is_original":false,"owner_handle":"example","platform":"example","play_url":"https://example.com/example","title":"example","url":"https://example.com/example","video_count":0}],"query":"example","region":"example"}]}